Okta からフェデレーティッド認証を構成する
項目一覧
このガイドでは、Okta を IdPとして使用してフェデレーティッド認証を構成する方法を説明します。
Okta と Atlas を統合した後、会社の認証情報を使用して Atlas やその他の MongoDB Cloud サービスにログインできます。
注意
Okta の組み込み MongoDB Cloud アプリを使用している場合は、 Okta のドキュメントを使用できます。
独自の SAML アプリを作成する場合は、ここで説明されている手順に従います。
必要なアクセス権
フェデレーティッド認証を管理するには、インスタンスにフェデレーション設定を委任している 1 つ以上の組織に対する Organization Owner
アクセス権が必要です。
前提条件
Okta を Atlas のIdPとして使用するには、次のものが必要です。
ルーティング可能なカスタムのドメイン名。
手順
以下の手順全体を通して、 Atlas フェデレーション管理コンソールには 1 つのブラウザ タブが開き、Okta アカウントには 1 つのタブが開いていると便利です。
ID プロバイダーとしての Okta の構成
Okta 発信元証明書をダウンロードします。
Okta アカウントで、管理者環境にアクセスするには、右上隅の Adminをクリックします。
左側のペインで、 Applications -> Applicationsに移動します。
[ Create App Integrationをクリックします。 SAML 2.0Sign-in methodNextで を選択し、 をクリックします。
App nameテキスト フィールドに目的のアプリケーション名を入力します。
オプションで、ログイメージを追加し、アプリの可視性を設定します。 [ Nextをクリックします。
Configure SAML画面で、次の情報を入力します。
フィールド値Single sign-on URL
http://localhost
Audience URI
urn:idp:default
重要
これらはプレースホルダー値であり、本番環境での使用を意図したものではありません。 これらは後の手順で置き換えます。
その他のフィールドを空にするか、デフォルト値に設定して、ページの下部にある [ Next ] をクリックします。
Feedback画面で、 I'm an Okta customer adding an internal appを選択し、 Finishをクリックします。
見出し [ SAML Signing Certificates ] の下のページの下部で、 Statusが
Active
の最新の証明書を見つけます。これは作成したばかりの証明書です。[ Actionsをクリックし、ドロップダウン メニューから [ Download certificate ] を選択します。 生成された証明書は
.cert
ファイルです。 この手順の後半で使用するために、.pem
証明書に変換する必要があります。 これを行うには、任意のターミナルを開き、次のコマンドを実行します。openssl x509 -in path/to/mycert.crt -out path/to/mycert.pem -outform PEM
[Federation Management Console] を開きます。
Atlas で、 Organization Settings ページに移動します。
まだ表示されていない場合は、以下から目的の組織を選択しますナビゲーション バーのOrganizationsメニュー
[Organizations] メニューの横にある [Organization Settings] アイコンをクリックします。
[ Organization Settings ]ページが表示されます。
Federated Authentication Settings で、[Open Federation Management App] をクリックします。
Atlas に Okta 認証情報を提供します。
左側のペインで [ Identity Providersをクリックします。 以前にIdPを構成したことがある場合は、ページの右上隅にあるAdd Identity Providerをクリックし、次にSetup Identity Providerをクリックします。 以前にIdPを設定したことがない場合は、 Setup Identity Providerをクリックします。
Configure Identity Provider画面で、次の情報を入力します。
フィールド値Configuration Name
構成を識別する説明ラベル
Issuer URI
Fill with Placeholder Values
Single Sign-On URL
Fill with Placeholder Values
Identity Provider Signature Certificate
前のステップで Okta から受け取った証明書
Request Binding
HTTP POST
Response Signature Algorithm
SHA-256
Okta 構成の値を表示するには、 Nextボタンをクリックします。
[Finish] をクリックします。
SAML 統合を構成します。
Okta アカウントで、SAML アプリケーションの ページに戻り、 Generalタブが選択されていることを確認します。
SAML Settingsペインで [ Edit ] をクリックします。
General Settingsページで、 Nextをクリックします。
Configure SAML画面で、次の情報を入力します。
Okta データ フィールド値Single sign on URL
Assertion Consumer Service URL Atlas FMC からの。
チェックボックス:
Check Use this for Recipient URL and Destination URL.
Allow this app to request other SSO URLsをクリアします。
Audience URI (SP Entity ID)
Audience URI Atlas FMC からの。
Default RelayState
オプションで、IdP に RelayState URL を追加して、ユーザーを選択した URL に送信し、ログイン後の不要なリダイレクトを回避します。次のものを使用できます。
目的地RelayState URLMongoDB Atlas
Login URL は、Atlasフェデレーション管理アプリ の ID プロバイダー構成用に生成されました。
MongoDB サポート ポータル
https://auth.mongodb.com/app/salesforce/exk1rw00vux0h1iFz297/sso/saml MongoDB University
https://auth.mongodb.com/home/mongodb_thoughtindustriesstaging_1/0oadne22vtcdV5riC297/alndnea8d6SkOGXbS297 MongoDB Community フォーラム
https://auth.mongodb.com/home/mongodbexternal_communityforums_3/0oa3bqf5mlIQvkbmF297/aln3bqgadajdHoymn297 MongoDB フィードバック エンジン
https://auth.mongodb.com/home/mongodbexternal_uservoice_1/0oa27cs0zouYPwgj0297/aln27cvudlhBT7grX297 MongoDB JIRA
https://auth.mongodb.com/app/mongodbexternal_mongodbjira_1/exk1s832qkFO3Rqox297/sso/saml Name ID format
未指定
Application username
メールアドレス
Update application username on
作成と更新
Okta 構成ページでClick Show Advanced Settingsリンクをクリックし、次の値が設定されていることを確認します。
Okta データ フィールド値Response
Signed
Assertion Signature
Signed
Signature Algorithm
RSA-SHA256
Digest Algorithm
SHA256
Assertion Encryption
Unencrypted
残りのAdvanced Settingsフィールドはデフォルト状態のままにします。
[ Attribute Statements (optional) ] セクションまで下にスクロールし、次の値を持つ 4 つの属性を作成します。
名前名前の形式値名
未指定
user.firstName
姓
未指定
user.lastName
重要
名前列の値は大文字と小文字を区別します。 表示されているとおりに正確に入力します。
注意
Okta が Active Directory に接続されている場合、これらの値が異なる場合があります。 適切な値については、ユーザーの名、姓、完全なメール アドレスを含む Active Directory フィールドを使用します。
(任意)ロール マッピングを使用する場合は、 Group Attribute Statements (optional)セクションまで下にスクロールし、次の値を持つ属性を作成します。
名前名前の形式フィルター値MemberOf
未指定
正規表現に一致する
.*
このフィルターは、ユーザーに関連付けられているすべてのグループ名と一致します。 Atlas に送信されるグループ名をさらにフィルタリングするには、Filter フィールドとValue フィールドを調整します。
ページの下部にある [ Nextをクリックします。
Feedback 画面で、Finish をクリックします。
Atlas FMCのプレースホルダー値を置き換えます。
Okta アプリケーション ページで、ページの中央にあるView Setup Instructionsをクリックします。
Atlas FMCで、 Identity Providersページに移動します。 Okta を見つけて、 Editをクリックします。
以下のフィールドのプレースホルダー値を置き換えます。
FMC データ フィールド値Issuer URI
Identity Provider Issuer Okta 設定手順 ページの 値。
Single Sign-on URL
Identity Provider Single Sign-On URL Okta 設定手順 ページの 値。
Identity Provider Signature Certificate
Okta 設定手順 ページからX.509 Certificateをコピーし、内容を直接貼り付けます。
[Next] をクリックします。
[Finish] をクリックします。
ユーザーを Okta アプリケーションに割り当てます。
Okta アプリケーション ページで、[ Assignments ] タブをクリックします。
Okta を使用するすべての Atlas 組織ユーザーが登録されていることを確認します。
ドメインをマッピング
ドメインを IdP にマッピングすると、ドメインのユーザーを ID プロバイダー構成の Login URL に誘導する必要があることが Atlas に通知されます。
ユーザーは Atlas ログイン ページにアクセスする際に、メール アドレスを入力します。メール ドメインが IdP に関連付けられている場合、その IdP のログイン URL に送信されます。
重要
単一のドメインを複数の ID プロバイダーにマッピングできます。そうすると、MongoDB Cloud コンソールを使用してログインするユーザーは、ドメインにマップされた最初の一致する IdP に自動的にリダイレクトされます。
代替 ID プロバイダーを使用してログインするには、ユーザーは次のいずれかを行う必要があります。
希望する IdP を介して MongoDB Cloud ログインを開始します。または、
目的の IdPに関連付けられた Login URL を使用してログインします。
Federation Management Console を使用して、ドメインを IdP にマッピングします。
FMC を開きます。
Atlas で、 Organization Settings ページに移動します。
まだ表示されていない場合は、以下から目的の組織を選択しますナビゲーション バーのOrganizationsメニュー
[Organizations] メニューの横にある [Organization Settings] アイコンをクリックします。
[ Organization Settings ]ページが表示されます。
Manage Federation Settings で、[Open Federation Management App] をクリックします。
ドメイン マッピング情報を入力します。
[Add a Domain] をクリックします。
Domains 画面で、Add Domain をクリックします。
ドメイン マッピングに次の情報を入力します。
フィールド説明表示名
ドメインを簡単に識別するためのラベル。
ドメイン名
ドメイン名 マッピングする
[Next] をクリックします。
ドメインの認証方法を選択します。
注意
検証方法は一度選択できますが、変更することはできません。別の検証方法を選択するには、ドメイン マッピングを削除して再作成します。
HTML ファイルをアップロードしてドメインを確認するか、DNS TXT レコードを作成してドメインを確認するかに応じて、適切なタブを選択します。
ドメインの所有者であることを検証するために、検証キーを含む HTML ファイルをアップロードします。
[HTML File Upload] をクリックします。
[Next] をクリックします。
Atlas によって提供される
mongodb-site-verification.html
ファイルをダウンロードします。HTMLファイルを所有するドメイン上の Web サイトにアップロードします。
<https://host.domain>/mongodb-site-verification.html
のファイルにアクセスできる必要があります。[Finish] をクリックします。
ドメインの所有権を検証するには、ドメイン プロバイダーで DNS TXT レコードを作成します。各 DNS レコードにより、特定の Atlas 組織と特定のドメインが関連付けされます。
[DNS Record] をクリックします。
[Next] をクリックします。
提供された TXT レコードをコピーします。TXT レコードの形式は次のとおりです。
mongodb-site-verification=<32-character string> ドメイン名プロバイダー(GoDaddy.com や networksolutions.com など)にログインします。
Atlas により提供される TXT レコードをドメインに追加します。
Atlas に戻り、Finish をクリックします。
ドメインを確認します。
Domains 画面には、IdP にマッピングした未確認ドメインと確認済みドメインの両方が表示されます。ドメインを確認するには、対象ドメインの Verify ボタンをクリックします。Atlas では、検証に成功したかどうかが画面上部のバナーで表示されます。
ドメインを ID プロバイダーに関連付ける
ドメインを正常に検証したら、 Federation Management Consoleを使用してドメインを Okta に関連付けます。
左側のナビゲーションで [ Identity Providers ] をクリックします。
ドメインに関連付ける IdP については、Associated Domains の横にある Edit をクリックします。
IdP に関連付けるドメインを選択します。
[Confirm] をクリックします。
ドメイン マッピングをテストする
重要
テストを開始する前に、IdP の バイパス SAML モード URL をコピーして保存します。Atlas 組織からロックアウトされた場合にフェデレーション認証をバイパスするには、この URL を使用します。
テスト中は、ロックアウトをさらに防ぐために、セッションを Federation Management Console にログインしたままにしておきます。
Bypass SAML Mode の詳細については、バイパス SAML モードを参照してください。
ドメインと Okta の統合をテストするには、 Federation Management Consoleを使用します。
プライベート ブラウザ ウィンドウで、Atlas ログイン ページに移動します。
確認済みのドメインのユーザー名(通常は電子メール アドレス)を入力します。
例
確認済みのドメインが mongodb.com
の場合は、username@mongodb.com
形式のメール アドレスを使用します。
Next をクリックします。ドメインを正しくマッピングした場合は、認証のために IdP にリダイレクトされます。認証に成功すると、Atlas にリダイレクトされます。
注意
IdP Login URL に直接移動することで、Atlas ログイン ページをバイパスできます。
(任意)組織をマッピングする
Federation Management Console を使用して、ドメインのユーザーに特定の Atlas 組織へのアクセス権を割り当てます。
Atlas で、Organization Settings ページに移動します。
まだ表示されていない場合は、以下から目的の組織を選択しますナビゲーション バーのOrganizationsメニュー
[Organizations] メニューの横にある [Organization Settings] アイコンをクリックします。
[ Organization Settings ]ページが表示されます。
組織をフェデレーション アプリケーションに接続します。
[View Organizations] をクリックします。
Atlas には、あなたが
Organization Owner
. であるすべての組織が表示されます。フェデレーション アプリケーションにまだ接続していない組織では、Actions 列に Connect ボタンが表示されます。
目的の組織の Connect ボタンをクリックします。
組織に IdP を適用します。
管理コンソールの Organizations 画面で次の作業を行います。
IdP にマッピングする組織の Name をクリックします。
Identity Provider 画面で、Apply Identity Provider をクリックします。
Atlas は、Atlas にリンクしたすべての IdP を表示する Identity Providers 画面にユーザーを誘導します。
組織に適用する IdP については、Add Organizations をクリックします。
Apply Identity Provider to Organizations モーダルで、この IdP が適用される組織を選択します。
[Confirm] をクリックします。
(任意)高度なフェデレーション認証オプションを構成する
フェデレーション ユーザーと認証フローをより詳細に制御するために、フェデレーション認証の次の詳細オプションを構成できます。
注意
フェデレーティッド認証の次の詳細オプションを使用するには、組織をマッピングする必要があります。
ログイン URL を使用して Atlas にサインインします
Okta アプリケーションに割り当てたすべてのユーザーは、 Login URLで Okta 認証情報を使用して Atlas にログインできます。 ユーザーは、 IdPにマッピングされた組織にアクセスできます。
重要
単一のドメインを複数の ID プロバイダーにマッピングできます。そうすると、MongoDB Cloud コンソールを使用してログインするユーザーは、ドメインにマップされた最初の一致する IdP に自動的にリダイレクトされます。
代替 ID プロバイダーを使用してログインするには、ユーザーは次のいずれかを行う必要があります。
希望する IdP を介して MongoDB Cloud ログインを開始します。または、
目的の IdPに関連付けられた Login URL を使用してログインします。
デフォルトの組織ロールを選択した場合、Login URL を使用して Atlas にログインする新しいユーザーには、指定したロールが付与されます。