この記事の内容
dropdown icon
シングルサインオンとコントロールハブ
    プロフィール
    名前とIDの形式
    シングルログアウト
コントロールハブをシボレスと統合してください
Webexメタデータをローカルシステムにダウンロードしてください
シボレスファイルで認証を設定してください
SAMLアサーション用のShibbolethサービスプロバイダーコンポーネントを設定してください
アサーション属性を設定してください
IdPメタデータをインポートして、テスト後にシングルサインオンを有効にする
Shibbolethを使用してコントロールハブでシングルサインオンを設定します
list-menuこの記事の内容
list-menuフィードバックがある場合

Control HubとShibbolethをIDプロバイダー(IdP)として使用するデプロイメントとの間のシングルサインオン(SSO)統合を設定できます。

シングルサインオンとコントロールハブ

シングルサインオン(SSO)は、ユーザーが1つまたは複数のアプリケーションにアクセスするための資格情報を提供できるようにするセッションまたはユーザー認証プロセスです。 このプロセスでは、権限が与えられているすべてのアプリケーションでユーザーを認証します。 これにより、ユーザーが特定のセッション中にアプリケーションを切り替えるときに、それ以上プロンプトが表示されなくなります。

セキュリティアサーションマークアップ言語(SAML 2.0)フェデレーションプロトコルは、Webex クラウドとアイデンティティプロバイダー(IdP)の間の SSO 認証を提供するために使用されます。

プロフィール

Webex アプリはウェブブラウザの SSO プロファイルのみをサポートしています。 ウェブブラウザの SSO プロファイルでは、Webex アプリは次のバインディングをサポートしています。

  • SPがPOSTを開始しました-> POSTバインディング

  • SPはリダイレクト-> POSTバインディングを開始しました

名前とIDの形式

SAML 2.0プロトコルは、特定のユーザーについて通信するためのいくつかのNameID形式をサポートしています。 Webex アプリは、次の NameID 形式をサポートしています。

  • urn:oasis:names:tc:SAML:2.0:nameid-format:transient

  • urn:oasis:names:tc:SAML:1.1:nameid-format:unspecified

  • urn:oasis:names:tc:SAML:1.1:nameid-format:emailAddress

IdPからロードするメタデータでは、最初のエントリはWebexで使用するように設定されています。

シングルログアウト

Webex アプリはシングルログアウトプロファイルをサポートしています。 Webex Appでは、ユーザーはアプリケーションからサインアウトできます。アプリケーションはSAMLシングルログアウトプロトコルを使用してセッションを終了し、IdPでサインアウトを確認します。 IdPがシングルログアウトに設定されていることを確認してください。

コントロールハブをシボレスと統合してください

設定ガイドにはSSO統合の具体例が示されていますが、すべての可能性を網羅した設定は提供されていません。 たとえば、nameid-format urn:oasis:names:tc:SAML:2.0:nameid-format:transientの統合手順は文書化されています。 urn:oasis:names:tc:SAML:1.1:nameid-format:unspecified or urn:oasis:names:tc:SAML:1.1:nameid-format:emailAddressなどの他の形式はSSO統合には使用できますが、ドキュメントの範囲外です。

Webex 組織のユーザー(Webex アプリWebex Meetings、およびコントロールハブで管理されているその他のサービスを含む)用にこの統合を設定してください。 Webex サイトがコントロールハブに統合されている場合、Webex サイトはユーザー管理を継承します。 Webex Meetingsこの方法でアクセスできず、Control Hubで管理されていない場合は、SSOを有効にするために別の統合を行う必要があります。Webex Meetings

統合手順では、ウェブサーバーとしてTomcat 7を使用するCentOS 7のシボレス2.4.5を参照してください。

始める前に

SSOとコントロールハブでは、IDPはSAML 2.0仕様に準拠している必要があります。 さらに、 IdPは次の方法で設定する必要があります。

Webexメタデータをローカルシステムにダウンロードしてください

1

コントロールハブにサインインしてください。

2

[管理] > [セキュリティ] > [認証] に移動します。

3

「ID プロバイダー」タブに行き、「 SSOを有効にする」をクリックします。

4

IdPを選択してください。

5

あなたの組織の証明書の種類を選んでください:

  • シスコによる自己署名: この選択をお勧めします。 証明書に署名させてください。 5年に1回更新するだけで済みます。
  • 公的認証局による署名-より安全ですが、 メタデータを頻繁に更新する必要があります( IdPベンダーがトラストアンカーをサポートしていない限り)。

トラストアンカーは、 デジタル署名の証明書を検証する権限として機能する公開鍵です。 詳細については、 IdPのマニュアルを参照してください。

6

メタデータファイルをダウンロードしてください。

<org-ID>Webex メタデータのファイル名は idb-meta--SP.xml です。

シボレスファイルで認証を設定してください

Shibbolethをインストールすると、例を含む設定ファイルが提供されます。

1

/opt/shibboleth-idp/confディレクトリに移動して、サンプルファイルにアクセスしてください。

2

使用する認証方法を決めてください。たとえば、LDAPバインドなどです。Active Directory

3

handler.xml ファイルを次のように編集します。

コメント解除します

    <!--  Username/password login handler -->
    <ph:LoginHandler xsi:type="ph:UsernamePassword"
                  jaasConfigurationLocation="file:///opt/shibboleth-idp/conf/login.config">  
  <ph:AuthenticationMethod>urn:oasis:names:tc:SAML:2.0:ac:classes:PasswordProtectedTransport
</ph:AuthenticationMethod>
    </ph:LoginHandler>

コメント

<ph:LoginHandler xsi:type="ph:RemoteUser"> 
<ph:AuthenticationMethod>urn:oasis:names:tc:SAML:2.0:ac:classes:unspecified</ph:AuthenticationMethod>
    </ph:LoginHandler>
4

認証できるように、Active Directoryあなたの詳細を記入してください。 login.configファイルにコンフィグを提供してください。

ShibUserPassAuth {
   edu.vt.middleware.ldap.jaas.LdapLoginModule required
      ldapUrl="ldap://ad0a.cisco.net:389"
      ssl="false"
      tls="false"
      baseDn="cn=Users,dc=cisco,dc=net"
      subtreeSearch="true"
      userFilter="sAMAccountName={0}"
      bindDn="cn=Administrator,cn=Users,dc=cisco,dc=net"
      bindCredential="ThePassword";
};

SAMLアサーション用のShibbolethサービスプロバイダーコンポーネントを設定してください

1

Webex SP からダウンロードしたファイルを /opt/shibboleth-idp/metadata ディレクトリに追加します。

2

relying-party.xml ファイルを編集し、DefaultRellyingPartyタグの後に、Webex用のSAMLアサーションの詳細を追加します。

 <rp:RelyingParty id="https://idbroker.webex.com/ea7c1420-711d-4916-95f8-
22de53230d1e"
              provider="https://shib9a.cisco.net/idp/shibboleth"
              defaultSigningCredentialRef="IdPCredential">
            <rp:ProfileConfiguration xsi:type="saml:SAML2SSOProfile"
                includeAttributeStatement="true"
                assertionLifetime="PT5M" assertionProxyCount="0"
                signResponses="never" signAssertions="always"
                encryptAssertions="conditional" encryptNameIds="never"
                includeConditionsNotBefore="true"/>
        </rp:RelyingParty>

idには、Webex メタデータファイルの EntityId 値を使用する必要があります。 例のIDをあなたの組織のEntityIdに置き換えてください。

3

metadata: metadataProviderタグの中に、ファイルの場所を追加してください:

 <metadata:MetadataProvider id="ShibbolethMetadata" xsi:type="metadata:Chaini
ngMetadataProvider">
        <metadata:MetadataProvider id="IdPMD" xsi:type="metadata:FilesystemMetad
ataProvider" metadataFile="/opt/shibboleth-idp/metadata/idp-metadata.xml" maxRefreshDelay="P1D" />
    <!--     Cisco UCXN Configuration               -->
   <metadata:MetadataProvider xsi:type="FilesystemMetadataProvider" xmlns="urn:m
ace:shibboleth:2.0:metadata" id="ucxn9a" metadataFile="/opt/shibboleth-idp/metad
ata/ucxn9a-single-agreement.xml" />
    <!--     Cisco CUCM Configuration               -->
   <metadata:MetadataProvider xsi:type="FilesystemMetadataProvider" xmlns="urn:m
ace:shibboleth:2.0:metadata" id="cucm9a" metadataFile="/opt/shibboleth-idp/metad
ata/cucm9a.cisco.net-single-agreement.xml" />
    <!--     Cisco CI Configuration               
   <metadata:MetadataProvider xsi:type="FilesystemMetadataProvider" xmlns="urn:m
ace:shibboleth:2.0:metadata" id="CI" metadataFile="/opt/shibboleth-idp/metadata/
idb-meta-ea7c1420-711d-4916-95f8-22de53230d1e-SP.xml" />
    </metadata:MetadataProvider>

SPメタデータは、Webex組織のメタデータをアップロードした場所にあるShibbolethファイルシステムのファイルから取得されます。

アサーション属性を設定してください

1

データコネクターセクションで、ユーザーに関する属性を取得する場所を指定します。

Active Directory、IDはMyLDAPです。

<resolver:DataConnector id="MyLDAP" xsi:type="dc:LDAPDirectory"
      ldapURL="ldap://ad0a.cisco.net:389"
      baseDN="cn=Users,dc=cisco,dc=net"
      principal="Administrator@cisco.net"
      principalCredential="ThePassword">
        <dc:FilterTemplate>
            <![CDATA[
                (sAMAccountName=$requestContext.principalName)
            ]]>
        </dc:FilterTemplate>
    </resolver:DataConnector>

2

属性定義セクションでは、TransientIDの設定に既にあるものをそのまま使用してください。

3

SPが期待している属性を追加し、属性ソースで何にマップするかを定義します。

mail属性(のメールアドレス属性Active Directory)をuid(WebexのユーザーID)にマップします。

<resolver:AttributeDefinition id="mail-attr" xsi:type="ad:Simple" 
sourceAttributeID="mail">
        <resolver:Dependency ref="MyLDAP" />
        <resolver:AttributeEncoder xsi:type="enc:SAML2String" name="uid" />
     </resolver:AttributeDefinition>

4

attribute-filter.xml ファイルで、各 SP 契約に指定する属性を定義してください。

ユーザーのメールアドレスに対応する uid 属性を Webex に提供してください。

Webex との SP 契約にアトリビュート uid を公開してください。

<!--  Release the attributes to cisco CI Cloud  -->
    <afp:AttributeFilterPolicy id="ReleaseToCI">
        <afp:PolicyRequirementRule xsi:type="basic:AttributeRequesterString" 
value="https://idbroker.webex.com/ea7c1420-711d-4916-95f8-22de53230d1e" />
        <afp:AttributeRule attributeID="transientId">
            <afp:PermitValueRule xsi:type="basic:ANY"/>
        </afp:AttributeRule>
        <afp:AttributeRule attributeID="mail-attr">
            <afp:PermitValueRule xsi:type="basic:ANY" />
        </afp:AttributeRule>
    </afp:AttributeFilterPolicy>

attribute-resolver.xml で作成したルールには、mail-attr 属性を Webex と一致する entityId に解放するポリシーが含まれているはずです。

5

シボレスサーバーのメタデータファイルを /opt/shibboleth-idp/metadata にダウンロードしてください。 ファイル名は idp-metadata.xml です。

IdPメタデータをインポートして、テスト後にシングルサインオンを有効にする

Webex メタデータをエクスポートし、IdP を設定し、IdP メタデータをローカルシステムにダウンロードしたら、Control Hub から Webex 組織にインポートする準備が整います。

始める前に

アイデンティティプロバイダー(IdP)インターフェースからSSO統合をテストしないでください。 サービスプロバイダー起動(SP起動)フローのみをサポートしているので、この統合にはControl Hub SSOテストを使用する必要があります。

1

1つ選んでください:

  • ブラウザのコントロールハブの証明書選択ページに戻り、 次へをクリックしてください。
  • コントロールハブがブラウザタブで開かなくなったら、もう一度開いてください。 Control Hubのカスタマービューから、[管理] > [セキュリティ] > [認証] に移動し、IdPを選択して、[アクション] > [メタデータのインポート] を選択します。
2

IdPメタデータのインポートページで、 IdPメタデータファイルをページにドラッグアンドドロップするか、 ファイルブラウザオプションを使用してメタデータファイルを見つけてアップロードします。 「次へ」をクリックします。

できれば、より安全なオプションを使うべきです。 これは、IdPがパブリックCAを使用してメタデータに署名した場合にのみ可能です。

それ以外の場合は、 安全性の低いオプションを使用する必要があります。 これには、メタデータが署名されていないか、自己署名されていないか、 プライベートCAによって署名されていない場合も含まれます。

Oktaはメタデータに署名しないので、Okta SSO統合には「 安全性が低い」を選択する必要があります。

3

テストSSOセットアップを選択し、 新しいブラウザタブが開いたら、サインインしてIdPで認証します。

認証エラーが発生した場合は、 資格情報に問題がある可能性があります。 ユーザー名とパスワードを確認して、もう一度やり直してください。

Webex アプリのエラーは通常、SSO 設定に問題があることを意味します。 この場合は、手順、特にControl HubのメタデータをコピーしてIdP設定に貼り付ける手順をもう一度実行してください。

SSOサインインを直接確認するには、この画面で [ URLをクリップボードにコピー] をクリックして、 プライベートブラウザウィンドウに貼り付けることもできます。 そこから、 SSOでのサインインを順を追って進めることができます。 このステップは、 あなたがサインインしている既存のセッションにあるかもしれないアクセストークンによる誤検知を防ぎます。

4

コントロールハブのブラウザタブに戻ってください。

  • テストが成功したら、「 テスト成功」を選択してください。SSOをオンにして、「 次へ」をクリックしてください。
  • テストが失敗した場合は、「 テスト失敗」を選択してください。SSOをオフにして、「 次へ」をクリックしてください。

SSOの設定は、 最初のラジオボタンを選択してSSOを有効にしない限り、組織では有効になりません。

次にすべきこと

Cisco Webex Control HubOktaからWebexクラウドへのユーザープロビジョニングを行う場合は、「Oktaユーザーの同期」の手順を使用してください。

Entra Cisco Webex Control Hub IDからWebexクラウドへのユーザープロビジョニングを行いたい場合は、「 Microsoft Entra IDユーザーを同期」の手順を使用してください。

「 自動メールを抑制する」の手順に従って、組織内の新しい Webex アプリユーザーに送信されるメールを無効にすることができます。 このドキュメントには、 組織内のユーザーにコミュニケーションを送る際のベストプラクティスも含まれています。

この投稿記事は役に立ちましたか?
この投稿記事は役に立ちましたか?