この記事の内容
概要
テスト済みのSSO IDP
dropdown icon
シングル・サインオンのセットアップ
    IDプロバイダーの要件
    SAML契約を確立してください
    Webex アイデンティティサービスを設定してください
管理します
dropdown icon
トラブルシューティング
    SSOのトラブルシューティングの要件
    Webex アプリ、お使いの IdP、Webex サービス間の SAML フローのトラブルシューティングを行います
    SSOエラーのトラブルシューティング
    関連情報
コントロールハブのシングルサインオン統合
list-menuこの記事の内容
list-menuフィードバックがある場合

組織内に独自のIDプロバイダー(IdP)がある場合は、Control HubでSAML IdPを組織と統合してシングルサインオン(SSO)を行うことができます。SSOを使用すると、ユーザーは組織内のWebexアプリアプリケーションやその他のアプリケーションに単一の共通の認証情報セットを使用できます。

概要

シングルサインオン(SSO)を統合する前は、Webexはデフォルトで基本認証を使用しています。 基本認証では、ユーザーはサインインのたびに Webex のユーザー名とパスワードを入力する必要があります。 組織内に独自のIDプロバイダー(IdP)がある場合は、Control Hub for SSOで組織と統合できます。 SSOを使用すると、ユーザーは組織内のWebexアプリケーションに単一の共通の認証情報セットを使用できます。

基本認証を使いたい場合は、何もする必要はありません。 ただし、 特に組織ですでにIdPを使用している場合は、 基本認証はSSOよりも安全性が低く、ユーザーにとって不便である可能性があることを考慮してください。 基本認証でセキュリティを強化するには、Control Hubの多要素認証(MFA) を使用することをお勧めします。 詳細については、「Control Hub で多要素認証統合を有効にする」を参照してください。

テスト済みのSSO IDP

以下のウェブアクセス管理およびフェデレーションソリューションは、Webex 組織向けにテストされました。 以下にリンクされているドキュメントでは、 特定のIDプロバイダー(IdP)をWebex組織と統合する方法を説明しています。

これらのガイドでは、コントロールハブ (https://admin.webex.com)で管理されるWebexサービスのSSO統合について説明しています。 サイトのSSO統合(Webex Meetings サイト管理で管理)を探している場合は、サイトのシングルサインオンの設定を読んでください。Cisco Webex

組織内の複数のアイデンティティプロバイダーに SSO を設定したい場合は、「Webex の複数の IDP を使用する SSO 」を参照してください。

ご利用のIdPが以下に表示されない場合は、この記事の「SSO設定」タブの大まかな手順に従ってください。

シングル・サインオンのセットアップ

シングルサインオン(SSO)を使用すると、組織の共通IDプロバイダー(IdP)に認証することで、ユーザーはWebexに安全にサインインできます。 Webex アプリは Webex サービスを使用して Webex プラットフォームアイデンティティサービスと通信します。 IDサービスは、IDプロバイダー(IdP)で認証します。

コントロールハブで設定を開始します。 このセクションでは、サードパーティのIdPを統合するための大まかな一般的な手順について説明します。

IdPでSSOを設定すると、任意の属性をUIDにマップできます。 たとえば、、メールエイリアスuserPrincipalName、代替メールアドレス、 またはその他の適切な属性をUIDにマップします。 IdPは、 サインイン時にユーザーのメールアドレスの1つをUIDと一致させる必要があります。 Webexは、最大5つのメールアドレスをUIDにマッピングすることをサポートしています。

Webex SAMLフェデレーションを設定するときは、メタデータ設定にシングルログアウト(SLO)を含めることをお勧めします。 この手順は、アイデンティティプロバイダー(IdP)とサービスプロバイダー(SP) の両方でユーザートークンが無効になるようにするために重要です。 この設定が管理者によって行われていない場合、Webexはユーザーにブラウザを閉じて開いたままのセッションを無効にするように警告します。

IDプロバイダーの要件

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

  • 名前IDフォーマット属性を urn: Oasis: names: TC: SAML: 2.0: 名前IDフォーマット:トランジェントに設定します

  • 導入しているSSOの種類に応じて、IdPにクレームを設定してください。

    • SSO(組織用) —組織を代表してSSOを設定する場合は、 ディレクトリコネクタで選択された属性、またはWebex IDサービスで選択されたものと一致するユーザー属性にマップされる値を持つuid属性名を含むようにIdPクレームを設定します。 (この属性には、 電子メールアドレスやユーザー・プリンシパル名などがあります。)

    • パートナーSSO(サービスプロバイダーのみ)-サービスプロバイダーの管理者で、 サービスプロバイダーが管理する顧客組織がパートナーSSOを使用するように設定している場合は、IdPクレームに(uidではなく) mail属性を含めるように設定してください。 値は、ディレクトリコネクタで選択された属性、 またはWebex IDサービスで選択された属性と一致するユーザー属性にマップする必要があります。

    SSOまたはパートナーSSOのカスタム属性のマッピングの詳細については、 ディレクトリコネクタの導入ガイドを参照してください。

  • パートナーSSOのみ。 アイデンティティプロバイダーは、複数のアサーションコンシューマーサービス(ACS)URLをサポートする必要があります。 アイデンティティプロバイダーで複数のACS URLを設定する方法の例については、以下を参照してください。

  • サポートされているブラウザを使用してください。Mozilla FirefoxまたはGoogle Chromeの最新バージョンをお勧めします。

  • ブラウザのポップアップブロッカーをすべて無効にしてください。

設定ガイドには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統合には使用できますが、ドキュメントの範囲外です。

SAML契約を確立してください

Webex プラットフォームアイデンティティサービスとあなたの IdP の間で SAML 契約を結ぶ必要があります。

SAML契約を成立させるには、2つのファイルが必要です。

  • Webexに渡すIdPからのメタデータファイル。

  • WebexからIdPに渡すメタデータファイル。

Flow of metadata file exchange between Webex and the identity provider.

IdPからのメタデータファイルはIdPを識別し、SAML認証リクエストの送信先をWebexに伝えます。 このファイルには通常、IdPエンティティID、署名証明書、サポートされているNameID形式、および1つ以上のシングルサインオンサービスのURLが含まれています。

IdPメタデータのラベルと値は、IDプロバイダーによって異なります。 IdPからエクスポートしたメタデータファイルを使用して、次の表で対応するフィールドを特定してください。 IdP固有のセットアップガイダンスについては、テスト済みのSSO IdPを参照してください。

テーブル 1.IdP メタデータフィールド
メタデータ値または要素目的

IdP エンティティ ID

entityIDEntityDescriptor要素について

SAML契約でIdPを識別します。

認証リクエストの署名要件

WantAuthnRequestsSigned属性、存在する場合

IdPがWebexからの署名付き認証リクエストを必要とするかどうかを示します。

署名証明書

KeyDescriptor use="signing"と X509Certificate

WebexがIdPからの署名付きSAMLレスポンスを検証するために使用する証明書を提供します。

名前とIDの形式

NameIDFormat

IdPがSAMLアサーションで送信できるユーザー識別子の形式を定義します。

SSO サービス URL

SingleSignOnServiceと、Binding="urn:oasis:names:tc:SAML:2.0:bindings:HTTP-POST"または Binding="urn:oasis:names:tc:SAML:2.0:bindings:HTTP-Redirect"

Webexがサインインリクエストを送信するために使用できるIdPエンドポイントを提供します。

ユーザー属性

Attribute要素(IdP メタデータで提供されている場合)

IdPがSAMLアサーションに含める可能性のあるユーザー属性を識別します。

アイデンティティサービスのメタデータファイルは、WebexをSAMLサービスプロバイダーとして識別し、IdPがSAML契約を完了するために必要な値を提供します。 このファイルを使用して、サービスプロバイダーのエンティティID、署名証明書と暗号化証明書、サポートされているNameID形式、ログアウトエンドポイント、およびアサーションコンシューマーサービスURLを設定します。

次の表は、IdPが必要とする可能性があるWebex IDサービスのメタデータフィールドを示しています。

テーブル 2.Webex ID サービスのメタデータフィールド
メタデータ値または要素目的

サービスプロバイダーのエンティティ ID

entityIDEntityDescriptor要素について

IdP設定でWebex IDサービスを識別します。

認証リクエストへの署名

AuthnRequestsSigned属性

Webex IDサービスが認証リクエストに署名するかどうかを示します。

アサーション署名

WantAssertionsSigned属性

Webex IDサービスに署名付きアサーションが必要かどうかを示します。

署名証明書

KeyDescriptor use="signing"と X509Certificate

IdPがWebex IDサービスによって署名されたメタデータまたはメッセージを検証するために使用できる証明書を提供します。

暗号化証明書

KeyDescriptor use="encryption"と X509Certificate

IdPがWebex IDサービスのSAMLアサーションを暗号化するために使用できる証明書を提供します。

シングルログアウトサービスのURL

SingleLogoutServiceと、Binding="urn:oasis:names:tc:SAML:2.0:bindings:HTTP-Redirect"または Binding="urn:oasis:names:tc:SAML:2.0:bindings:HTTP-POST"

IdPでログアウトが設定されている場合、Webexログアウトエンドポイントを提供します。

名前とIDの形式

NameIDFormat

Webex アイデンティティサービスが SAML 契約でサポートしている NameID 形式を一覧表示します。

アサーションコンシューマーサービス URL

AssertionConsumerServiceと Binding="urn:oasis:names:tc:SAML:2.0:bindings:HTTP-POST"

IdPが認証後にSAMLアサーションを投稿するWebexエンドポイントを提供します。

WebexでSAML契約を設定するときは、IdPメタデータを使用して、IDプロバイダーが必要とするIdPエンティティID、署名証明書、NameID形式、およびSSOサービスURLを確認してください。

Webex アイデンティティサービスを設定してください

このタスクは、Control Hub で Webex を ID プロバイダーとして設定し、その IdP を介して認証するユーザーのルーティングルールを定義するときに使用します。

サードパーティのSAML IdPを設定する場合は、SSOをテストして有効化する前に、IdPとWebex IDサービスのメタデータ値を使用してSAML契約を完了してください。

1

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

2

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

3

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

4

WebexをIdPとして選択し、次へをクリックします。

5

Webex IdP の仕組みを読んで理解したことを確認して、[次へ] をクリックしてください。

6

ルーティングルールを設定します。

ルーティングルールを追加すると、IdPが追加され、「 IDプロバイダー」タブに表示されます。
詳細については、「Webex の複数の IDP を使用する SSO」を参照してください。

管理します

SSOを設定したら、Control HubのSSO管理機能を使用して統合を維持してください。

証明書の更新、メタデータのエクスポートまたはインポート、SSOアラートの管理、シングルログアウトの設定、SSOの無効化、および自己回復オプションの使用ができます。

詳細については、「Control Hub のシングルサインオン(SSO)統合の管理」を参照してください。

トラブルシューティング

SSO統合で問題が発生した場合は、このセクションの要件と手順を使用して、IdPとWebex間のSAMLフローをトラブルシューティングしてください。

Webex アプリ、お使いの IdP、Webex サービス間の SAML フローのトラブルシューティングを行います

以下は、Webex アプリ、Webex サービス、Webex プラットフォームアイデンティティサービス、ID プロバイダー (IdP) 間のメッセージの流れです。

SAML flow between Webex App, Webex Services, Webex Platform Identity Service, and the identity provider.
1

https://admin.webex.com にアクセスすると、SSOが有効になっていると、アプリはメールアドレスの入力を求めます。

Control Hub sign in screen.

アプリは、メールアドレスを検証するWebexサービスに情報を送信します。

Information sent to Webex service for email address verification.

2

アプリは、トークンを求めるGETリクエストをOAuth認証サーバーに送信します。 リクエストは、IDサービス、SSO、またはユーザー名とパスワードのフローにリダイレクトされます。 認証サーバーのURLが返されます。

GETリクエストはトレースファイルにあります。

GET request details in the log file.

パラメータセクションでは 、サービスはOAuthコード、リクエストを送信したユーザーの電子メール、 およびClientID、redirectURI、Scopeなどのその他のOAuthの詳細を探します。

Parameters section displaying OAuth details such as ClientID, redirectURI and Scope.

3

Webex アプリは SAML HTTP POST を使用して IdP から SAML アサーションをリクエストします。

SSOが有効になっていると、アイデンティティサービスの認証エンジンはSSOのIdP URLにリダイレクトします。 メタデータが交換されたときに提供された IdP URL。

Authentication engine redirects users to the identity provider URL specified during the metadata exchange.

トレースツールでSAML POSTメッセージをチェックしてください。 IDPブローカーによってリクエストされたIdPへのHTTP POSTメッセージが表示されます。

SAML POST message to the identity provider.

RelayStateパラメータは、IdPからの正しい返信を示します。

RelayState parameter showing the correct reply from the identity provider.

SAMLリクエストのデコードバージョンを確認してください。AuthNは必須ではなく、回答の宛先はIdPの宛先URLでなければなりません。 名前IDフォーマットが正しいエンティティID(spNameQualifier)のIdPで正しく設定されていることを確認してください

SAML request showing the nameid-format configured in the identity provider.

IdPの名前ID形式が指定され、 SAML契約の作成時に契約の名前が設定されました。

4

アプリの認証は、オペレーティングシステムのWebリソースとIdPの間で行われます。

IdPとIdPに設定されている認証メカニズムに応じて、IdPから開始されるフローは異なります。

Identity provider placeholder for your organization.

5

アプリはHTTP PostをIDサービスに送り返します。これには、IdPによって提供され、最初の契約で合意された属性が含まれます。

認証が成功すると、アプリはSAML POSTメッセージで情報をIDサービスに送信します。

SAML POST message to the identity service.

RelayStateは、どのエンティティIDがアサーションを要求しているかをアプリがIdPに伝える前のHTTP POSTメッセージと同じです。

HTTP POST message indicating which EntityID is requesting the assertion from the identity provider.

6

IdP からウェベックスへの SAML アサーション。

SAML assertion from the identity provider to Webex.

SAML assertion from the identity provider to Webex.

SAML assertion from the identity provider to Webex: NameID format unspecified.

SAML assertion from the identity provider to Webex: NameID format email.

SAML assertion from the identity provider to Webex: NameID format transient.

7

IDサービスは認証コードを受け取り、それがOAuthアクセストークンと更新トークンに置き換えられます。 このトークンは、ユーザーに代わってリソースにアクセスするために使用されます。

ID サービスは IdP からの回答を検証した後、Webex アプリがさまざまな Webex サービスにアクセスできるようにする OAuth トークンを発行します。

OAuth token allowing Webex App to access the different Webex services.

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