ポータルでの SAML 準拠の ID プロバイダーの構成

このトピックの内容

SAML サインイン操作
SAML ID プロバイダー
必要な情報
SAML ID プロバイダーでのポータルの構成
エンタープライズアカウントを管理者として指定
SAML ID プロバイダーの変更

SAML (Security Assertion Markup Language) は、エンタープライズ ID プロバイダーとサービスプロバイダー (この場合は Portal for ArcGIS) との間で認証/認可データを安全に交換するためのオープン規格です。これを実現するための方法は、SAML Web シングルサインオンと呼ばれます。ポータルは SAML 2.0 に準拠し、SAML 2 Web シングルサインオンをサポートする ID プロバイダーと一体化しています。SAML を設定するメリットは、ユーザーが Portal for ArcGIS にアクセスする際に追加のログインアカウントを作成する必要がなくなるということです。代わりにユーザーは、エンタープライズアイデンティティストア内ですでに設定されているログインアカウントを使用します。この手順は、エンタープライズログインアカウントの設定ドキュメントで説明されています。

必要に応じて、アイデンティティストア内のエンタープライズグループに関するメタデータをポータルに提供することもできます。これにより、ポータルに、アイデンティティストア内の既存のエンタープライズグループを利用するグループを作成することができます。メンバーがポータルにログインすると、コンテンツ、アイテム、およびデータへのアクセスは、エンタープライズグループで定義されているメンバーシップルールで管理されます。必要なエンタープライズグループメタデータを指定しなくても、グループは作成できます。ただし、メンバーシップルールはアイデンティティストアではなく、Portal for ArcGIS で管理されます。

SAML サインイン操作

Portal for ArcGIS は、サービスプロバイダー (SP) が開始するエンタープライズログインと、ID プロバイダー (IDP) が開始するエンタープライズログインをサポートしています。これらのログイン操作は、それぞれ異なります。

サービスプロバイダーが開始するログイン

サービスプロバイダーが開始するログインでは、ユーザーがポータルに直接アクセスすると、(ポータルで管理されている)組み込みアカウントまたは SAML 準拠の ID プロバイダーで管理されているアカウントを使用してサインインするオプションが表示されます。ユーザーは、SAML ID プロバイダーオプションを選択すると、Web ページ (エンタープライズのログインマネージャーと呼ばれる) にリダイレクトされ、エンタープライズのユーザー名とパスワードを入力するよう求められます。ユーザーのログインの確認時に、エンタープライズ ID プロバイダーはログインしようとしているユーザーの確認済み ID を Portal for ArcGIS に通知し、ユーザーがポータルの Web サイトにもう一度リダイレクトされます。

ユーザーが組み込みアカウントオプションを選択した場合は、ポータルの Web サイトのサインインページが表示されます。その後、ユーザーは、組み込みのユーザー名とパスワードを入力して Web サイトにアクセスできます。このオプションを無効にすることはできません。組み込みアカウントオプションは、SAML 準拠の ID プロバイダーが使用できない場合のフェイルセーフとして使用できます。

ID プロバイダーが開始するログイン

ID プロバイダーが開始するログインでは、ユーザーはエンタープライズのログインマネージャーに直接アクセスし、自分のアカウントを使用してサインインします。ユーザーが自分のアカウント情報を送信すると、ID プロバイダーは SAML レスポンスを直接 Portal for ArcGIS に送信します。その後、ユーザーはログインし、ポータルの Web サイトにリダイレクトされ、再び組織にサインインしなくても直ちにリソースにアクセスできます。

組み込みアカウントを使用してサインインするオプションは、エンタープライズのログインマネージャーからは使用できません。組み込みアカウントを使用して組織サイトにサインインするには、メンバーは、ポータルの Web サイトに直接アクセスする必要があります。

SAML ID プロバイダー

Portal for ArcGIS で使用が認められているのは、以下の SAML 準拠の ID プロバイダーです。

上記の各リンクには、ID プロバイダーから必要なメタデータを取得する手順の説明があります。Portal for ArcGIS を使用して ID プロバイダーを構成する手順について以下で説明します。開始する前に、エンタープライズ ID プロバイダーの管理者に問い合わせて、構成に必要なパラメーターを取得することをお勧めします。たとえば、組織で Microsoft Active Directory を使用している場合、エンタープライズ ID プロバイダー側で SAML を構成または有効化し、ポータル側で構成に必要なパラメーターを取得するための連絡先は、Microsoft Active Directory の管理者になります。

複数の SAML ID プロバイダーのサポート

SAML では、複数のアイデンティティストアストアを使用したポータルへのアクセスを許可できます。これは、組織内外に存在する複数ユーザーを管理するのに役立ちます。

これを実行するには、ポータルで使用可能にしたいアイデンティティストア間の信頼を構築します。これは通常、セキュリティ管理者が行います。信頼は Portal for ArcGIS では構成されません。信頼関係を構築したら、信頼済みのアイデンティティストアの 1 つをポータルに構成するだけです (以下の説明を参照)。ユーザーがポータルのWeb サイトまたは ID プロバイダーサイトにアクセスすると、信頼済みの ID プロバイダーのいずれかで管理されるエンタープライズアカウントを使用してサインインするオプションが表示されます。

必要な情報

Portal for ArcGIS は、ユーザーがエンタープライズログインを使用してログインするときに、特定の属性情報を ID プロバイダーから受信する必要があります。NameID は、Portal for ArcGIS とのフェデレーションが機能するように、ID プロバイダーが SAML レスポンスで送信する必要のある必須の属性です。IDP からユーザーがログインすると、Portal for ArcGIS によってユーザー名が NameID の新しいユーザーがユーザーストアに作成されます。NameID 属性によって送信される値に使用できる文字は、英数字、_ (アンダースコア)、 . (ドット) および @ (アットマーク) です。その他の文字はエスケープされ、Portal for ArcGIS によってアンダースコアが付加されたユーザー名が作成されます。

Portal for ArcGIS は、エンタープライズログインアカウントの givenName 属性と email address 属性を、ID プロバイダーから取得して入力することをサポートしています。ユーザーがエンタープライズログインアカウントを使用してサインインし、Portal for ArcGIS が givenname と email または mail という名前の属性を取得した場合、Portal for ArcGIS はユーザーアカウントのフルネームと電子メールアドレスに ID プロバイダーから取得した値を入力します。ユーザーが通知を受信できるようにするために、エンタープライズ ID プロバイダーから取得した email address を渡すことをお勧めします。

SAML ID プロバイダーでのポータルの構成

組織サイトの管理者としてポータル Web サイトにサインインし、[組織] > [サイト設定] > [セキュリティ] の順にクリックします。
[エンタープライズログイン] セクションで、[ID プロバイダーの設定] ボタンをクリックし、表示されたウィンドウに組織名 (たとえば、「City of Redlands」) を入力します。ユーザーがポータル Web サイトにアクセスすると、このテキストが SAML サインインオプションの一部に表示されます (たとえば、「City of Redlands アカウントを使用」)。
ユーザーが [自動] または [アカウントをポータルに追加した後] のどちらで組織に加入できるかを選択します。1 番目のオプションを選択すると、ユーザーは、管理者から招待されなくても、自分のエンタープライズログインを使用して組織サイトにサインインできます。ユーザーのアカウントは、最初にサインインしたときに自動的に組織サイトに登録されます。2 番目のオプションを選択すると、管理者は、コマンドラインユーティリティまたはサンプル Python スクリプトを使用して必要なアカウントを組織サイトに登録する必要があります。ユーザーは、アカウントが登録された時点で、組織サイトにサインインできるようになります。
ヒント:
少なくとも 1 つのエンタープライズアカウントをポータルの管理者として指定し、最初の管理者アカウントを降格するか削除することをお勧めします。また、[アカウントの作成] ボタンとポータル Web サイトのサインアップページ (signup.html) を無効化して、ユーザーが自分のアカウントを作成できないようにしておくこともお勧めします。手順については、下記の「エンタープライズアカウントを管理者として指定」セクションをご参照ください。
SAML 準拠のエンタープライズ ID プロバイダーに関する必要なメタデータ情報を指定します。これを実行するには、ポータルがアクセスしてメタデータ情報を取得するためのソースを指定します。認定プロバイダーからメタデータを取得する手順の詳細については、上記の「SAML ID プロバイダー」セクションをご参照ください。メタデータ情報のソースとして、次の 3 つを指定できます。
- URL - ID プロバイダーに関するメタデータ情報を返す URL を入力します。
  注意:
  エンタープライズ ID プロバイダーに自己署名証明書が含まれている場合、メタデータの HTTPS URL を指定しようとしたときに、エラーが発生することがあります。このエラーは、Portal for ArcGIS が ID プロバイダーの自己署名証明書を確認できないために発生します。代わりに、URL内で HTTP を使用するか、下記の他のオプションのいずれかを使用するか、信頼できる証明書を使用して ID プロバイダーを構成してください。
- ファイル - ID プロバイダーに関するメタデータ情報を含むファイルをアップロードします。
- パラメーター - 以下のパラメーターを指定することによって、ID プロバイダーに関するメタデータ情報を直接入力します。
  - ログイン URL - ユーザーのサインインを許可するために Portal for ArcGIS が使用する URL を入力します。
  - 証明書 - エンタープライズ ID プロバイダーの X.509 証明書を入力します。この証明書を使用して、Portal for ArcGIS は、エンタープライズ ID プロバイダーから送信された SAML レスポンスのデジタル署名を確認することができます。
注意:
指定する必要のあるメタデータ情報のソースがわからない場合は、ID プロバイダーの管理者に問い合わせてください。
構成手順を実行して ID プロバイダーとの信頼を構築するには、使用しているエンタープライズ ID プロバイダーにポータルのサービスプロバイダーのメタデータを登録します。ポータルからメタデータを取得する場合、2 つの方法があります。
- 組織サイトの [サイト設定] ページの [セキュリティ] セクションで、[サービスプロバイダーの取得] ボタンをクリックします。これにより、組織のメタデータが表示され、XML ファイルとしてコンピューターに保存できます。
- メタデータの URL を開き、XML ファイルとしてコンピューターに保存します。この URL は、https://webadaptor.domain.com/arcgis/sharing/rest/portals/self/sp/metadata?token=<token> (例: https://samltest.domain.com/arcgis/sharing/rest/portals/self/sp/metadata?token=G6943LMReKj_kqdAVrAiPbpRloAfE1fqp0eVAJ-IChQcV-kv3gW-gBAzWztBEdFY) です。https://webadaptor.domain.com/arcgis/sharing/rest/generateToken を使用して、トークンを生成できます。[Generate Token] ページに URL を入力する場合は、[Webapp URL] フィールドで、ID プロバイダーサーバーの完全修飾ドメイン名を指定します。[IP Address] や [IP Address of this request's origin] など、その他のオプションの選択はサポートされていないため、これらのオプションを選択すると、無効なトークンが生成される場合があります。
認定プロバイダーにポータルのサービスプロバイダーのメタデータを登録する手順の詳細については、上記の「SAML ID プロバイダー」セクションをご参照ください。
必要に応じて、アイデンティティストア内のエンタープライズグループに関するメタデータをポータルに提供します。
1. 組織の管理者として ArcGIS Portal Directory にサインインします。URL の形式は https://webadaptor.domain.com/arcgis/portaladmin です。
2. [Security] > [Config] > [Update Identity Store] の順にクリックします。
3. [Group store configuration (in JSON format)] テキストボックスにグループ構成の JSON を入力します。
  - アイデンティティストアが Windows Active Directory の場合、次のテキストをコピーして、サイト固有の情報を含むよう変更します。
    { "type": "WINDOWS", "properties": { "isPasswordEncrypted": "false", "userPassword": "secret", "user": "mydomain\\winaccount" } }
    ほとんどの場合、ユーザーとユーザーパスワードのパラメーターの値を変更するだけです。パスワードをプレーンテキストで入力しても、ポータルの構成ディレクトリに保存または表示される際には暗号化されます。ユーザーパラメーターに使用するアカウントには、ネットワーク上で Windows グループの名前を検索するための権限のみが必要です。可能な限り、パスワードに有効期限のないアカウントを使用します。
  - アイデンティティストアが LDAP の場合、次のテキストをコピーして、サイト固有の情報を含むよう変更します。
    { "type": "LDAP", "properties": { "userPassword": "secret", "isPasswordEncrypted": "false", "user": "uid=admin\,ou=system", "ldapURLForUsers": "ldap://bar2:10389/ou=users\,ou=ags\,dc=example\,dc=com", "ldapURLForRoles": "ldap://bar2:10389/dc=example,dc=com", "usernameAttribute": "cn", "caseSensitive": "false", "userSearchAttribute": "cn", "memberAttributeInRoles": "member", "rolenameAttribute":"cn" } }
    ほとんどの場合、user、userPassword、ldapURLForUsers、ldapURLForUsers の各パラメーターの値を変更するだけです。LDAP の URL は、LDAP 管理者が提供する必要があります。user パラメーターに使用するアカウントは、組織サイト内のグループ名を検索する権限を持つ必要があります。パスワードをプレーンテキストで入力しても、ポータルの構成ディレクトリに保存または表示される際には暗号化されます。
    LDAP が大文字と小文字を区別するように構成されている場合は、caseSensitive パラメーターを false に設定します。
4. ユーザーストア構成に JSON を入力したら、[Update Configuration] をクリックして変更を保存し、ポータルを再起動します。

エンタープライズアカウントを管理者として指定

エンタープライズアカウントをポータルの管理者として指定する方法は、ユーザーが [自動] と [アカウントをポータルに追加した後] のどちらで組織に加入できるかによって決まります。

自動的に組織に加入する

ユーザーが自動的に組織に加入することを許可するオプション ([自動]) を選択した場合は、ポータル管理者として使用するエンタープライズアカウントでログインして、ポータル Web サイトのホームページを開きます。

アカウントが最初に自動的にポータルに追加されるときに、ユーザーロールが割り当てられます。アカウントのロールを変更できるのは、組織サイトの管理者のみです。そのため、初期管理者アカウントを使用してポータルにサインインし、管理者ロールにエンタープライズアカウントを割り当てる必要があります。

ポータルの Web サイトを開き、SAML ID プロバイダーを使用してサインインするオプションをクリックし、管理者として使用するエンタープライズアカウントの認証情報を入力します。このアカウントが別のユーザーのアカウントである場合、そのユーザーにポータルにサインインさせて、アカウントがポータルに登録されるようにします。
アカウントがポータルに追加されたことを確認して、[サインアウト] をクリックします。ブラウザーのキャッシュと cookie を消去します。
ブラウザーを開いたまま、ポータルの Web サイトを開き、組み込みポータルアカウントを使用してサインインするオプションをクリックし、Portal for ArcGIS を設定したときに作成した初期管理者アカウントの認証情報を入力します。
ポータルの管理に使用するエンタープライズアカウントを検索し、そのロールを [管理者] に変更します。[サインアウト] をクリックします。

これで、選択したエンタープライズアカウントがポータルの管理者になりました。

エンタープライズアカウントをポータルに手動で追加する

アカウントをポータルに追加した後でのみユーザーが組織に加入することを許可するオプション ([アカウントをポータルに追加した後]) を選択した場合は、コマンドラインユーティリティまたはサンプル Python スクリプトを使用して、必要なアカウントを組織に登録する必要があります。ポータルの管理に使用するエンタープライズアカウントに必ず [管理者] ロールを選択してください。

初期管理者アカウントの権限の降格または削除

代わりのポータル管理者アカウントができたため、初期管理者アカウントにユーザーロールを割り当てたり、このアカウントを削除したりできます。詳細については、「初期管理者アカウントについて」をご参照ください。

ユーザーが自分のアカウントを作成できないようにする

ポータルへのアクセスのセキュリティを保護したら、ポータル Web サイトの [アカウントの作成] ボタンとサインアップページ (signup.html) を無効にして、ユーザーが自分のアカウントを作成できないようにすることをお勧めします。このようにすると、すべてのメンバーがエンタープライズアカウントおよび認証情報を使用してポータルにサインインするようになり、必要のない組み込みアカウントは作成できなくなります。詳細な手順については、「組み込みポータルアカウントを作成するユーザーの機能の無効化」をご参照ください。

SAML ID プロバイダーの変更

[ID プロバイダーの削除] ボタンを使用して、現在登録されている ID プロバイダーを削除できます。このボタンは、SAML 準拠の ID プロバイダーを設定した場合にのみ有効化されます。ID プロバイダーを削除したら、必要に応じて新しい ID プロバイダーを設定できます。

このトピックへのフィードバック