Cisco Webex Teams スポークの設定
Cisco Webex Teams でカスタム OAuth アプリケーションを作成するか、カスタム Cisco Webex 認証情報を使用して ServiceNow インスタンスと Cisco Webex Teams をデータ連携し、ServiceNow 要求を認証します。
始める前に
- 統合ハブサブスクリプションを要求します。
- Cisco Webex Teams スポークを有効にします。
- 必要なロール:admin
認証には、OAuth 2.0 またはカスタム認証情報、Cisco Webex 認証情報のいずれかを使用できます。
OAuth プロバイダーとして Cisco Webex Teams を登録
Cisco Webex Teams アプリケーションの構成中に生成された情報を使用し、Cisco Webex Teams を OAuth プロバイダーとして登録して、ServiceNow インスタンスが OAuth 2.0 トークンを要求できるようにします。
始める前に
必要なロール:admin
手順
- 移動先 すべて > システム OAuth > アプリケーションレジストリー.
-
[New] をクリックします。
「どのような OAuth アプリケーションですか?」というメッセージが表示されます。
- [サードパーティ OAuth プロバイダーに接続します] を選択します。
-
フォームに、これらの値を入力します。
表 : 1. アプリケーションレジストリフォーム フィールド 説明 名前 レコードを一意に識別する名前を入力します。たとえば、次のように入力します。 Cisco Webex Teams OAuth クライアント ID Cisco Webex Teams アプリケーション構成中に作成されたクライアント ID アプリケーション構成。 クライアントシークレット Cisco Webex Teams アプリケーション構成中に作成されたクライアントシークレット。 認証 URL OAuth 認証コードのエンドポイント。「https://webexapis.com/v1/authorize」と入力します。 トークン URL OAuth サーバートークンエンドポイント。「https://webexapis.com/v1/access_token」と入力します。 トークン失効 URL OAuth サーバートークン失効エンドポイントです。 リダイレクト URL 次の形式の OAuth コールバックエンドポイント: https://<instance>.service-now.com/oauth_redirect.do OAuth API スクリプト 要求と応答をカスタマイズするスクリプトです。[OauthCiscoWebexTeamsUtils] を選択します。 ロゴ URL アプリケーションロゴとして使用するイメージを含む URL です。 デフォルトの権限許可タイプ トークンを確立するために使用される権限許可のタイプ。[認証コード] を選択します。 リフレッシュ トークンの有効期間 リフレッシュトークンが有効になる時間 (秒) デフォルトの時間は 8,640,000 秒です。 PKCE が必要 (PKCE required) パブリッククライアントが認証に PKCE を要求できるようにするオプション。 注:PKCE が有効になっている場合、[デフォルトの権限許可タイプ] として使用できるのは [認証コード] のみです。アプリケーション このレコードを含むアプリケーションスコープです。 アクセス可能 このレジストリにアクセスできるアプリケーションスコープです。 有効 アプリケーションレジストリを積極的に使用するためのオプションです。 相互認証を有効にします トークンの要求と取り消しに相互認証を使用するオプション。このオプションでは、相互認証プロファイルを指定する必要があります。 - フォームヘッダーを右クリックし、[保存] をクリックします。
次のタスク
OAuth エンティティプロファイルに の権限があることを確認します。
Cisco Webex Teams スポーク用の OAuth 認証情報レコードの作成
Cisco Webex Teams アカウントの認証情報レコードを作成します。 Cisco Webex Teams スポークの接続および資格情報エイリアスでは、これらの認証情報を使用してアクションを許可します。
始める前に
必要なロール:admin
手順
- 移動先 すべて > 統合ハブ > 接続 & 認証情報 > 認証情報.
-
[New] をクリックします。
「作成する認証情報のタイプは?」というメッセージが表示されます。
- [OAuth 2.0 認証情報] を選択します。
-
フォームに、これらの値を入力します。
表 : 2. OAuth 2.0 認証情報フォーム フィールド 説明 名前 レコードを一意に識別する名前を入力します。例:「Cisco Webex Teams Cred」。 アクティブ 認証情報レコードを積極的に使用するオプションです。 OAuth エンティティ プロファイル OAuth プロバイダーとして Cisco Webex Teams を登録する際に作成される OAuth プロファイル。例:Cisco Webex Teams OAuth プロファイル。 適用先 認証情報がネットワークのすべてのMID サーバーに適用されるか、または 1 つ以上の特定の MID サーバーに適用されるかを指定するオプションです。[MID サーバー] フィールドでこの認証情報を使用する MID サーバーを指定します。 順番 この認証情報を適用する順番です。たとえば、100 です。 認証情報エイリアス スポークに関連付けられた認証情報エイリアスです。 - フォームヘッダーを右クリックし、[送信]をクリックします。
- OAuth トークンを生成するには、[OAuth トークンの 取得] 関連リンクをクリックします。
Cisco Webex Teams スポーク用の接続および資格情報エイリアスレコードの作成
Cisco Webex Teams アカウントの認証情報レコードを作成します。 Cisco Webex Teams スポークの接続および資格情報エイリアスでは、これらの認証情報を使用してアクションを許可します。
始める前に
必要なロール:admin
手順
- 移動先 すべて > 統合ハブ > 接続 & 認証情報 > 接続と認証情報エイリアス.
-
CiscoWebexTeams レコードを開きます。
CiscoWebexTeams 接続および資格情報エイリアスが表示されます。
-
[接続] タブの [新規] をクリックします。
-
フォームに、これらの値を入力します。
表 : 3. Cisco Webex Teams の接続と資格情報 フィールド 説明 名前 Cisco Webex Teams スポークの HTTPS 接続レコードの名前 認証情報 Cisco Webex Teams スポーク用に作成された認証情報の名前
「Cisco Webex Teams スポーク用の OAuth 認証情報レコードの作成」で作成された値を指定します。接続 URL 接続 URL を指定するオプション。
値を https://webexapis.com として指定 - フォームヘッダーを右クリックし、[送信]をクリックします。
Visa スポークの接続および資格情報エイリアスの作成
アカウントへの接続レコードを作成します。 。Visa スポーク接続および資格情報エイリアスでは、これらの接続を使用して でアクションを実行します。
手順
- 移動先 すべて > 接続 & 認証情報 > 接続と認証情報エイリアス.
- のエイリアスレコードを開きます。
- [接続] タブで、[新規] をクリックします。
-
フォームの各フィールドに入力します。
表 : 4. 接続フォーム フィールド 説明 名前 レコードを一意に識別する名前を入力します。例を次に示します。 <Application-Name> 接続。 認証情報 Visa スポーク用に作成された認証情報レコード 例:<Application-Name> Cred。 接続エイリアス 接続に関連付けられているエイリアスレコードです。 ホスト サーバーがインストールされるターゲットホストの完全修飾ドメイン名です。例を次に示します。 <host>.<domain>.com 接続 URL に接続するためのベース URL です。次のように入力します。 有効 接続レコードを積極的に使用にするオプションです。 ドメイン アクションを実行するドメインです。 Override default port (デフォルト ポートに上書きする) 接続で使用されるターゲット ポート。空白の場合は、デフォルトのポートが使用されます。 MID サーバーを使用 この接続に MID サーバー を使用するオプション。チェックボックスが選択されている場合、[MID サーバー詳細構成] 関連リストのフィールドを定義します。 - [送信] をクリックします。