ID プロバイダの構成

このページは Apigee と Apigee ハイブリッドに適用されます。

Apigee Edge ドキュメントを表示する

統合ポータルでは、次の表で定義されている認証タイプをサポートする ID プロバイダを定義できます。

認証タイプ	説明
組み込み	認証を受けるために、ユーザーが自身の認証情報（ユーザー名とパスワード）を統合ポータルに渡す必要があります。新しいポータルを作成すると、組み込み ID プロバイダが構成され、有効になります。 ユーザーの視点から見たログイン エクスペリエンスを理解するには、ユーザー認証情報（組み込みプロバイダ）を使用してポータルにログインするをご覧ください。
SAML（ベータ版）	Security Assertion Markup Language（SAML）は、シングル サインオン（SSO）環境の標準プロトコルです。SAML を使用した SSO 認証を使用すると、ユーザーは新しいアカウントを作成することなく Apigee 統合ポータルにログインできます。ユーザーは、集中管理されたアカウント認証情報を使用してログインします。 ユーザーの視点から見たログイン エクスペリエンスを理解するには、SAML 認証（ベータ版）を使用してポータルにログインするをご覧ください。

統合ポータルにおける SAML 認証の利点

統合ポータルの ID プロバイダとして SAML を使用することには次の利点があります。

• デベロッパー プログラムを一度だけ設定し、それを複数の統合ポータルで再利用できる。統合ポータルを作成するときに、設定済みのデベロッパー プログラムを選択します。そうすれば、要件が変わったときにデベロッパー プログラムを更新または変更するのが簡単です。
• ユーザー管理を完全に制御できる
  会社の SAML サーバーを統合ポータルに接続します。組織を離れたユーザーが中央でプロビジョニング解除されると、そのユーザーは SSO サービスで認証されず、統合ポータルを使用できなくなります。

組み込み ID プロバイダの構成

以下のセクションに従って、組み込み ID プロバイダを構成します。

組み込み ID プロバイダ ページへのアクセス

組み込み ID プロバイダにアクセスするには:

1. サイド ナビゲーション バーで [Publish] > [Portals] を選択し、ポータルのリストを表示します。
2. チームを表示するポータルの行をクリックします。
3. ポータルのランディング ページで [Accounts] をクリックします。または、上部のナビゲーション バーにあるポータル プルダウン メニューから [Accounts] を選択します。
4. [Authentication] タブをクリックします。
5. [Identity providers] セクションで、[Built-in] プロバイダ タイプをクリックします。
   
6. 以下のセクションに従って、組み込み ID プロバイダを構成します。
   • 組み込み ID プロバイダの有効化
   • ポータルへの登録のメールアドレスまたはドメインによる制限
   • メール通知を構成する

組み込み ID プロバイダの有効化

組み込み ID プロバイダを有効にするには:

1. 組み込み ID プロバイダ ページにアクセスします。
2. [Provider Configuration] セクションで をクリックします。

3. [Enabled] チェックボックスをオンにして ID プロバイダを有効にします。
   

   組み込み ID プロバイダを無効にするには、このチェックボックスをオフにします。

   注: ユーザーがログインできるようにするには、少なくとも 1 つの ID プロバイダを有効にする必要があります。

4. [Save] をクリックします。

ポータルへの登録のメールアドレスまたはドメインによる制限

ポータルでアカウントを作成できる個々のメールアドレス（[e-mail]）またはメールドメイン（some-company.com、@ が先頭にない）を識別して、ポータルへの登録を制限します。

ネストされたすべてのサブドメインを照合するには、ドメインまたはサブドメインの先頭に *. ワイルドカード文字列を追加します。たとえば、*.example.com は [e-mail]、[e-mail] などに一致します。

これを空白のままにした場合は、ポータルへの登録に任意のメールアドレスを使用できます。

注:

• 統合ポータルでユーザー アカウントを作成するに沿って、ユーザーがアカウントを作成すると、メールアドレスのアクセスが許可されると、登録プロセスを完了するためのリンクが記載された確認メールが送信されます。
• 制限が構成される前に作成された既存のアカウントを持つユーザーは、（メールまたはメールドメインにアクセス権が付与されているかどうかに関係なく）引き続きポータルにログインできます。
• メールアドレスとドメインの値では、大文字と小文字は区別されません。
• ユーザー アカウントの手動アクティベーションを構成するもご覧ください。

ポータルへの登録をメールアドレスまたはメールドメインによって制限するには:

1. 組み込み ID プロバイダ ページにアクセスします。
2. [Provider Configuration] セクションで をクリックします。
3. [Account restrictions] セクションで、ポータルへの登録とログインを許可するメールアドレスまたはメールドメインをテキスト ボックスに入力し、[+] をクリックします。
4. 必要に応じて、その他のエントリを追加します。
5. エントリを削除するには、そのエントリの横の [x] をクリックします。
6. [Save] をクリックします。

メール通知を構成する

注: ポータルから送信されるメール通知用に SMTP サーバーを構成することをおすすめします。SMTP サーバーの構成をご覧ください。

組み込みプロバイダの場合は、次のメール通知を有効にして構成できます。

メール通知	受信者	トリガー	説明
アカウント通知	API プロバイダ	ポータル ユーザーが新規アカウントを作成する	ユーザー アカウントの手動アクティベーションを必須とするようポータルを構成している場合は、ポータル ユーザーがログインできるようにする前に、ユーザー アカウントを手動でアクティブにする必要があります。 注: 新しいユーザー アカウント登録の通知を構成していることを確認してください。 ベータ版リリースでは、ポータル ユーザーに対して、ログインするにはアカウントの手動アクティベーションを行う必要があることは通知されません。手動アクティベーションを構成した場合は、新しいユーザー アカウントのアクティベーションを迅速に行うことをおすすめします。
アカウント確認	ポータル ユーザー	ポータル ユーザーが新規アカウントを作成する	アカウントの作成を確認するための安全なリンクを提供します。リンクの有効期間は 10 分です。

メール通知を構成する場合:

• テキストのフォーマットには、HTML タグを使用します。テストメールを送信して、フォーマットが想定どおりに表示されていることを確認します。

• 次の変数を挿入できます。これらの変数は、メール通知が送信されるときに該当する値に置き換えられます。

  変数	説明
  {{firstName}}	名
  {{lastName}}	姓
  {{email}}	メールアドレス
  {{siteurl}}	ライブポータルへのリンク
  {{verifylink}}	アカウント確認に使用するリンク

メールによる通知を構成するには:

1. 組み込み ID プロバイダ ページにアクセスします。

2. メール通知の送信先を構成するには:

   • 新しいユーザー アカウントのアクティベーションのための API プロバイダの場合は、[Account Notify] セクションの [] をクリックします。
   • ID を確認するポータル ユーザーの場合は、[Account Verify] セクションで [] をクリックします。

3. [Subject] フィールドと [Body] フィールドを編集します。

4. [Send Test Email] をクリックして、指定したメールアドレスにテストメールを送信します。

5. [Save] をクリックします。

SAML ID プロバイダ（ベータ版）の構成

注: これはSAML ID プロバイダのベータ版リリースです。

以下のセクションに沿って、SAML ID プロバイダを構成します。

注意: ID プロバイダによって開始されたログインフローは、セキュリティ上のリスク（ログインの CSRF や DDOS 攻撃のリスクなど）をもたらすため、サポートされていません。ユーザーが統合ポータルの [Sign In] をクリックして認証を開始する、統合ポータルで開始するログインフローを使用することをおすすめします。

SAML ID プロバイダ ページへのアクセス

SAML ID プロバイダにアクセスするには:

1. サイド ナビゲーション バーで [Publish] > [Portals] を選択し、ポータルのリストを表示します。
2. チームを表示するポータルの行をクリックします。
3. ポータルのランディング ページで [Accounts] をクリックします。または、上部のナビゲーション バーにあるポータル プルダウン メニューから [Accounts] を選択します。
4. [Authentication] タブをクリックします。
5. [Identity providers] セクションで、[SAML] プロバイダ タイプをクリックします。
   

6. 以下のセクションに従って、SAML ID プロバイダを構成します。

   • SAML ID プロバイダを有効にする
   • SAML 設定を構成する
   • SAML ID プロバイダのカスタム ユーザー属性の構成
   • 新しい証明書をアップロードする

SAML ID プロバイダの有効化

SAML ID プロバイダを有効にするには:

1. SAML ID プロバイダ ページにアクセスします。
2. [Provider Configuration] セクションで をクリックします。

3. [Enabled] チェックボックスをオンにして ID プロバイダを有効にします。

   

   SAML ID プロバイダを無効にするには、このチェックボックスをオフにします。

   注: ユーザーがログインできるようにするには、少なくとも 1 つの ID プロバイダを有効にする必要があります。

4. [Save] をクリックします。

5. カスタム ドメインが構成されている場合は、SAML ID プロバイダでのカスタム ドメインの使用をご覧ください。

SAML 設定の構成

SAML 設定を構成するには:

1. SAML ID プロバイダ ページにアクセスします。
2. [SAML Settings] 欄で をクリックします。

3. [SP metadata URL] の横にある [Copy] をクリックします。
   

   注: SP メタデータ URL を入力するには、SAML ID プロバイダが有効になっている必要があります。

4. サービス プロバイダ（SP）メタデータ ファイルの情報を使用して、SAML ID プロバイダを構成します。

   SAML ID プロバイダでは、メタデータ URL のみを提供するよう求められる場合と、メタデータ ファイルから特定の情報を抽出してそれをフォームに入力しなければならない場合があります。
   
   後者の場合は、コピーしたメタデータ URL をブラウザに貼り付けて SP メタデータ ファイルをダウンロードし、必要な情報を抽出します。たとえば、SP メタデータ ファイル内の次の要素からエンティティ ID またはログイン URL を抽出できます。

   注: SP メタデータ ファイルでは、ログイン URL は AssertionConsumerService（ACS）URL と呼ばれます。
   • <md:EntityDescriptor xmlns:md="urn:oasis:names:tc:SAML:2.0:metadata" ID="diyyaumzqchrbui-a5vnmu1sp8qzekbd.apigee-saml-login" entityID="diyyaumzqchrbui-a5vnmu1sp8qzekbd.apigee-saml-login">
   • <md:AssertionConsumerService Binding="urn:oasis:names:tc:SAML:2.0:bindings:HTTP-POST" Location="https://diyyaumzqchrbui-a5vnmu1sp8qzekbd.portal-login.apigee.com/saml/SSO/alias/diyyaumzqchrbui-a5vnmu1sp8qzekbd.apigee-saml-login" index="0" isDefault="true"/>

5. ID プロバイダの SAML 設定を構成します。

   [SAML Settings] セクションで、次のフィールドを SAML ID プロバイダのメタデータ ファイルから取得した値に設定します。

   SAML 設定	説明
   ログイン URL	SAML ID プロバイダにログインするためにユーザーがリダイレクトされる宛先 URL。 例: https://dev-431871.oktapreview.com/app/googledev431871_devportalsaml_1/exkhgdyponHIp97po0h7/sso/saml
   ログアウト URL	SAML ID プロバイダからログアウトするためにユーザーがリダイレクトされる宛先 URL。 次の場合は、フィールドを空白のままにします。 ご利用の SAML ID プロバイダでログアウト URL が提供されていない場合 ユーザーが統合ポータルからログアウトしたときに SAML ID プロバイダからサインオフされないようにする場合 カスタム ドメインを有効にする必要がある場合（既知の問題を参照） 注: この項目は非推奨で、今後のリリースで削除される予定です。
   IdP エンティティ ID	SAML ID プロバイダの一意の ID。 例: http://www.okta.com/exkhgdyponHIp97po0h7

6. [Save] をクリックします。

SAML ID プロバイダのカスタム ユーザー属性の構成

SAML ID プロバイダとポータル ユーザー アカウントとの適切なマッピングを確保するには、SAML ID プロバイダに対して、次の表で定義されているカスタム ユーザー属性を作成して構成することをおすすめします。各カスタム属性の値を、ご利用の SAML ID プロバイダで定義されている対応するユーザー属性（Okta など）に設定します。

注: カスタム属性のマッピングは、次の表で定義されている 3 つの属性に制限されます。現時点では、カスタム属性マッピングは完全にはサポートされていません。

カスタム属性	例（Okta）
first_name	user.firstName
last_name	user.lastName
email	user.email

注: また、NameID 属性がユーザーのメールアドレスにマッピングされていることを確認します。このアドレスは、ポータル ユーザー アカウントの一意の ID として機能します。

次に、Okta をサードパーティの SAML ID プロバイダとして使用して、カスタム ユーザー属性と NameID 属性を構成する方法を示します。

SAML ID プロバイダでのカスタム ドメインの使用

SAML ID プロバイダを構成して有効にした後、ドメインをカスタマイズするに従ってカスタム ドメイン（developers.example.com など）を構成できます。

カスタム ドメインと SAML ID プロバイダ間で構成設定を同期しておくことが重要です。構成設定が同期されない場合、認証時に問題が発生する可能性があります。たとえば、SAML ID プロバイダに送信される認証リクエストには、カスタム ドメインを使用して定義されていない AssertionConsumerServiceURL が含まれる場合があります。

カスタム ドメインと SAML ID プロバイダの間で構成の設定を同期するには:

• SAML ID プロバイダを有効にして構成した後にカスタム ドメインを構成または更新した場合は、カスタム ドメイン構成を保存して有効にします。キャッシュが無効になるまで約 30 分待ってから、SAML 設定を構成するで説明されている通りに、サービス プロバイダ（SP）のメタデータ ファイルの更新された情報を使用して SAML ID プロバイダを再構成します。SP メタデータにカスタム ドメインが表示されます。

• SAML ID プロバイダを構成して有効にする前にカスタム ドメインを構成した場合は、SAML ID プロバイダが正しく構成されるようにカスタム ドメインをリセット（後述）する必要があります。

• SAML ID プロバイダをリセットする（無効にして再度有効にする）必要がある場合は、SAML ID プロバイダを有効にするで説明されているように、カスタム ドメインをリセットする（後述）必要もあります。

カスタム ドメインのリセット

カスタム ドメインをリセットする（無効にして有効にする）には:

1. 左側のナビゲーション バーで [Publish] > [Portals] を選択し、目的のポータルを選択します。
2. 上部のナビゲーション バーにあるプルダウン メニューまたはランディング ページで [設定] を選択します。
3. [Domains] タブをクリックします。
4. [Disable] をクリックして、カスタム ドメインを無効にします。
5. [Enable] をクリックして、カスタム ドメインを再度有効にします。

詳細については、ドメインのカスタマイズをご覧ください。

新しい証明書のアップロード

新しい証明書をアップロードするには:

1. SAML ID プロバイダから証明書をダウンロードします。
   

   注: 証明書は PEM 形式または PKCSS 形式にする必要があります。必要に応じて、x509 証明書を PEM 形式に変換します。

2. SAML ID プロバイダ ページにアクセスします。

3. 新しい証明書をアップロードする ID ゾーンの行をクリックします。

4. [Certificate] セクションで、 をクリックします。

5. [Browse] をクリックし、ローカル ディレクトリにある証明書を選択します。

6. [Open] をクリックして新しい証明書をアップロードします。
   [Certificate] の各フィールドが更新され、選択した証明書の情報が反映されます。
   

7. 証明書が有効で、期限切れになっていないことを確認します。

8. [Save] をクリックします。

x509 証明書の PEM 形式への変換

x509 証明書をダウンロードするは、PEM 形式に変換する必要があります。

x509 証明書を PEM 形式に変換するには:

1. SAML ID プロバイダのメタデータ ファイルから ds:X509Certificate element の内容をコピーし、任意のテキスト エディタに貼り付けます。
2. 次に、ファイルの先頭に以下の行を追加します。
   -----BEGIN CERTIFICATE-----
3. ファイルの最後に次の行を追加します。
   -----END CERTIFICATE-----
4. .pem 拡張子を使用してファイルを保存します。

次に、PEM ファイルの内容の例を示します。

-----BEGIN CERTIFICATE-----
MIICMzCCAZygAwIBAgIJALiPnVsvq8dsMA0GCSqGSIb3DQEBBQUAMFMxCzAJBgNV
BAYTAlVTMQwwCgYDVQQIEwNmb28xDDAKBgNVBAcTA2ZvbzEMMAoGA1UEChMDZm9v
MQwwCgYDVQQLEwNmb28xDDAKBgNVBAMTA2ZvbzAeFw0xMzAzMTkxNTQwMTlaFw0x
ODAzMTgxNTQwMTlaMFMxCzAJBgNVBAYTAlVTMQwwCgYDVQQIEwNmb28xDDAKBgNV
BAcTA2ZvbzEMMAoGA1UEChMDZm9vMQwwCgYDVQQLEwNmb28xDDAKBgNVBAMTA2Zv
bzCBnzANBgkqhkiG9w0BAQEFAAOBjQAwgYkCgYEAzdGfxi9CNbMf1UUcvDQh7MYB
OveIHyc0E0KIbhjK5FkCBU4CiZrbfHagaW7ZEcN0tt3EvpbOMxxc/ZQU2WN/s/wP
xph0pSfsfFsTKM4RhTWD2v4fgk+xZiKd1p0+L4hTtpwnEw0uXRVd0ki6muwV5y/P
+5FHUeldq+pgTcgzuK8CAwEAAaMPMA0wCwYDVR0PBAQDAgLkMA0GCSqGSIb3DQEB
BQUAA4GBAJiDAAtY0mQQeuxWdzLRzXmjvdSuL9GoyT3BF/jSnpxz5/58dba8pWen
v3pj4P3w5DoOso0rzkZy2jEsEitlVM2mLSbQpMM+MUVQCQoiG6W9xuCFuxSrwPIS
pAqEAuV4DNoxQKKWmhVv+J0ptMWD25Pnpxeq5sXzghfJnslJlQND
-----END CERTIFICATE-----