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