SSO の設定

This page is not available in the language you requested. You have been redirected to the English version of the page.
Link to this page copied to clipboard

前提条件、設定プロセス、SAML 設定、および本番移行

Not for use with personal data

SSO の設定は、貴社と Deque の間で SAML メタデータを交換することです。どちらの側も相手のシステムにアクセスする必要はありません。

前提条件

始める前に以下を確認してください:

  • 貴社のアイデンティティプロバイダーへの管理者アクセス
  • 対象となる Deque 製品のリスト
  • ユーザーがサインインするすべてのメールドメイン、サブドメインを含む
  • 貴社のアイデンティティプロバイダーに既に存在するテストユーザー
  • SAML の設定と接続テストができる技術的な担当者

設定プロセス

設定は 3 つのフェーズで進行します。IdP イニシエートログインの場合、プロセスは各 Deque 製品ごとに繰り返されます。

フェーズ 責任者 説明
1 Deque 接続を準備し、必要な値を送信します
2 貴社 SAML 2.0 アプリケーションを設定し、Deque にメタデータを送信します
3 Deque 設定を完了し、接続がテストの準備ができていることを確認します

SSO の依頼

helpdesk@deque.com または貴社の Deque 担当者に以下をお知らせください:

  • 貴社の組織名
  • 対象となるすべてのメールドメイン
  • 対象の Deque 製品
  • 貴社のアイデンティティプロバイダー
  • SP イニシエートまたは IdP イニシエートのログインを希望するかどうか
  • 貴社の技術的な担当者

その後、Deque は各製品に対して サービスプロバイダーエンティティID および SP メタデータ (XML) を送信します。IdP イニシエートセットアップの場合、各製品ごとに 1 つのエンティティ ID を受け取ることができます。

ログインフローの選択

Deque は 2 つの SSO ログインフローをサポートしています。貴社のアイデンティティプロバイダーの機能に基づいて選択してください:

フロー ユーザーエクスペリエンス 構成 プロバイダー固有の設定
SP イニシエート ユーザーは Deque のログインページでログインします 簡単: Deque がメタデータを提供し、貴社がそれをインポートします プロバイダー固有の構成は不要
IdP イニシエート ユーザーは IdP のアプリポータルから Deque を起動します より複雑: 貴社の IdP で SAML を設定します Okta、Entra ID、PingFederate などが必要です

どちらのフローも安全で、SAML 2.0 に準拠しています。以下で選択したセクションに進みます。

SP開始フロー設定

SP開始のログインの場合、Dequeがサービスプロバイダーの設定を管理します。あなたの役割は、Dequeのメタデータをアイデンティティプロバイダーにインポートすることです。

SP開始ログイン用SAML設定

組織ごとにユニークなSAML設定は1つだけです。

設定
Name ID形式 メールアドレス
Name ID値 ユーザーの仕事用メールアドレス
important

Name IDはユーザーの仕事用メールアドレスでなければならず、Dequeに登録されたアドレスと一致していなければなりません。あなたのアイデンティティプロバイダーがユーザー名や社員ID、または別のドメインのアドレスを送信すると、サインインに失敗するか、ログインページに繰り返し戻されます。これは最も一般的な設定問題ですので、テスト前に値を確認してください。

メタデータのインポート

Dequeから提供されたSPメタデータ(XMLファイルまたはURL)をインポートしてください。

  • あなたのアイデンティティプロバイダーに「メタデータインポート」または「メタデータURL」のオプションがある場合、DequeのメタデータURLを直接使用してください。
  • そうでなければ、XMLファイルをダウンロードして、アイデンティティプロバイダーにアップロードしてください。
  • あなたのIdPはほとんどの設定を自動で入力します。追加のSAML設定は不要です。

Dequeのメタデータをインポートした後、以下のテストに進んでください。

IdP開始フロー設定

IdP開始のログインの場合、あなたはDequeのメタデータを使用してアイデンティティプロバイダーにSAMLアプリケーションを手動で設定します。

エンティティID値の選択

エンティティIDはDequeから提供されたメタデータファイル内のmd:EntityDescriptor要素のentityID属性です。その値は/clients/<client name>で終わります。例:

https://auth.deque.com/.../axe.<your-domain>/endpoint/clients/axe-login-idp
important

/endpointで終わる値を使用しないでください。このファイルには両方の値が含まれていますが、短い方を使用するとサインインが失敗します。

ファイルに表示されるとおりの/clients/<client name>で終わる完全な値を使用してください。短縮したり編集したりしないでください。

この一つの値は、エンティティIDと返信URL(またはACS URL)の2か所で使用されます。両方のフィールドに同じ値を入力してください。

IdP開始ログイン用SAML設定

これらの設定はIdPのログインに対するすべてのアイデンティティプロバイダーに適用されます。

設定
エンティティID / オーディエンスURI /clients/<client name>で終わるエンティティIDの値
返信URL / ACS URL 同じエンティティIDの値
Name ID形式 メールアドレス
Name ID値 ユーザーの仕事用メールアドレス
署名 SAMLアサーションに署名
暗号化 なし
important

Name IDはユーザーの仕事用メールアドレスでなければならず、Dequeに登録されたアドレスと一致していなければなりません。あなたのアイデンティティプロバイダーがユーザー名や社員ID、または別のドメインのアドレスを送信すると、サインインに失敗するか、ログインページに繰り返し戻されます。これは最も一般的な設定問題ですので、テスト前に値を確認してください。

属性マッピング

最初のサインインで名前と姓がインポートされるように、以下の属性を送信してください。

属性名
http://schemas.xmlsoap.org/ws/2005/05/identity/claims/givenname
http://schemas.xmlsoap.org/ws/2005/05/identity/claims/surname

属性名の形式はプロバイダーによって異なります。OktaとMicrosoft Entra IDはUnspecifiedを使用し、PingFederateはurn:oasis:names:tc:SAML:2.0:attrname-format:uriを使用します。形式が間違って設定されていると、名前がインポートされず、初回のサインインで入力を求められます。

ユーザーの割り当て

アクセス権を持つべきユーザーとグループを割り当てます。ほとんどのアイデンティティプロバイダーは、割り当てられていないユーザーのサインインをブロックします。割り当ては認証できるユーザーの制御をしますが、Deque製品へのアクセスを付与するものではありません。

プロバイダー固有の設定

あなたのアイデンティティプロバイダー向けのガイドに沿ってください。

他のSAML 2.0に準拠したプロバイダーもサポートされています。上記のSAML設定を使用し、各フィールドの場所についてはプロバイダーのドキュメントを参照してください。

Dequeへメタデータを送信する

IDプロバイダーの設定後、メタデータをDequeに送信してください。メタデータURLまたはエクスポートされたXMLファイルのいずれかを送信します。どちらもDequeが必要とする値を含んでいます:

項目 メタデータ内の場所
シングルサインオンサービスURL md:SingleSignOnService要素のLocation属性
署名証明書 (X.509) ds:X509Certificate要素
エンティティID / 発行者 md:EntityDescriptorentityID属性

IdPによって開始されたログイン専用: IdP開始URL

メタデータに加えて、DequeにIdPによって開始された開始URLを送信してください。この値はメタデータに含まれておらず、別途送信する必要があります:

プロバイダー 場所
Okta アプリケーションを選び、次にあなたのアプリケーションを選び、次に一般、次にアプリ埋め込みリンク
Microsoft Entra ID 企業アプリケーションを選び、次にあなたのアプリケーション、次にプロパティ、次にユーザーアクセスURL
PingFederate クエリパラメータを含まない/idp/startSSO.pingの後にあなたのランタイムベースURL

DequeはあなたのSSO URLと証明書をインポートし、署名検証を有効にし、接続がテスト準備完了であることを確認します。接続は本稼働まで無効のままなので、既存のユーザーのサインインには影響しません。

テスト

tip

可能であれば、最初にIDプロバイダーのQAまたはテスト環境に対してテストしてください。その後、プロダクションに移行した場合は、Dequeにプロダクション用のメタデータを送信し、接続はそのデータから再構築されます。

以下を確認してください:

  1. ユーザーがサインインページに到達し、多要素認証を含めて認証されること。
  2. ユーザーがDequeに戻り、製品に到達すること。
  3. ユーザーの名前とメールアドレスがDequeのプロフィールに正しく表示されること。
  4. 既存のDequeアカウントを持たないユーザーが正しく作成されること。
  5. 既存のDequeアカウントを持つユーザーがアカウントリンクを正常に完了すること。

アカウントリンク

すでにDequeのログインを持っているユーザーは、最初のSSOサインイン時にDequeアカウントとIDプロバイダーのリンクを確認する必要があります。Dequeは確認メールを送り、ユーザーはプロセスを完了するためのリンクを選択します。これはユーザーごとに一度行われます。

important

本稼働前にユーザーを準備させてください。テスト中にリンク画面をキャプチャし、短い説明を提供できるようにしてください。明示的に以下を伝えてください:

  • 最初のSSOサインイン後に表示されるプロフィールページでメールアドレスを変更しないでください。
  • GoogleやGitHubのサインインボタンを使用しないでください。仕事用のメールアドレスを入力して続行してください。

本稼働

テストが成功し、ユーザーに通知したら、Dequeに接続を永久に有効化する時期を伝えてください。その時点から、有効化されたドメインのすべてのユーザーはIDプロバイダーを通じてサインインします。

ベースURL

地域または専用インスタンスのベースURLを使用してください。

ホスティングオプション ベースURL
SaaS、米国リージョン https://axe.deque.com
SaaS、EUリージョン https://axe-eu.deque.com
SaaS、オーストラリアリージョン https://axe-au.deque.com
SaaS、フランクフルトリージョン https://axe-frankfurt.deque.com
プライベートクラウドおよびオンプレミス 専用インスタンスURL