Zendesk スポークの設定
Zendeskでカスタム OAuth アプリケーションを作成してServiceNowインスタンスとZendeskをデータ連携し、ServiceNow要求を認証します。
始める前に
- 統合ハブサブスクリプションを要求します。
- Zendesk スポークをアクティブ化します。
- 必要なロール:admin
ZendeskOAuth クライアントを作成
ZendeskAPI 要求を認証するための OAuth クライアントを作成します。
始める前に
必要なロール:Zendesk admin
手順
- Web ブラウザーから、Zendesk を開きます。
-
アドミン認証情報を使用してログインします。
Zendeskエージェントワークスペースが開きます。
-
Zendesk エージェントワークスペースの左側のナビゲーションメニューで、管理アイコン (
) を選択します。
[アドミン] メニューが開きます。 -
[アドミン] メニューから、 チャネル > API.
[Zendesk API] ページが開きます。
- [OAuth クライアント] タブを選択し、[OAuth クライアントの追加] をクリックします。
- [新しい OAuth クライアントの作成] フォームが開きます。
-
フォームのフィールドに入力します。
表 : 1. [新しい OAuth クライアントの作成] フォーム フィールド 説明 クライアント名 OAuth クライアントの名前です。 説明 OAuth クライアントの簡単な説明。 会社 OAuth クライアントが Zendesk API を介してデータへのアクセスを許可する会社の名前。会社名は、 Zendesk API 要求の認証時に表示されます。 このフィールドは、 Zendesk アカウントが関連付けられている会社に基づいて自動的に入力されます。ただし、会社名は必要に応じて変更できます。
ロゴ Zendesk API 要求の認証時に表示されるロゴ。緑色の四角をクリックして、表示するロゴを見つけて選択します。 一意の識別子 OAuth クライアントの一意の識別子。このフィールドは、[クライアント名] フィールドで指定した OAuth クライアント名に基づいて自動的に入力されます。ただし、必要に応じて一意の識別子を変更できます。 注:一意の識別子は Zendesk コードでのみ使用されます。リダイレクト URL 認証後にユーザーがリダイレクトされる OAuth プロバイダーの URL。https://instance.service-now.com/oauth_redirect.do と入力します。<instance> はServiceNowインスタンスの名前です。 -
[保存] をクリックします。
[表示されるシークレットを保存してください (Please store the secret that will appear)] ダイアログボックスが開きます。
-
ダイアログボックスで、[OK] をクリックします。
ダイアログボックスが閉じ、フォームが再ロードされます。
-
[シークレット] フィールドの値をコピーします。
後で使用できるように安全な場所に保存してください。
Zendesk 接続の作成
インスタンスがアプリケーションからユーザーデータを取得できるように、Zendesk アプリケーションと ServiceNow インスタンスの間に接続を作成します。
始める前に
必要なロール:ServiceNow admin
手順
-
ServiceNowインスタンスから、 プロセス自動化 > フローデザイナー.
フローデザイナーが新しいタブで起動します。
- [接続] タブを選択します。
-
Zendesk 接続を見つけて、[接続を追加] をクリックします。
[接続を作成] ダイアログボックスが開きます。
-
ダイアログボックスで、フィールドに入力します。
表 : 2. [接続を作成] ダイアログボックス フィールド 説明 接続情報 接続名 Zendesk接続の名前です。このフィールドは、自動的に入力されます。 接続 URL 接続の URL。https://<subdomain>.zendesk.com と入力します。<subdomain> は組織のサブドメインです。 認証情報 OAuth クライアント ID Zendesk OAuth クライアントの一意の識別子。ZendeskOAuth クライアントを作成 で指定したものと同じ一意の識別子を入力します。 OAuth クライアントシークレット ZendeskOAuth クライアントに割り当てられているシークレット。ZendeskOAuth クライアントを作成 でコピーしたものと同じシークレットを入力します。 OAuth リダイレクト URL 認証後にユーザーがリダイレクトされる OAuth プロバイダーの URL。このフィールドは、ZendeskOAuth クライアントを作成で指定したリダイレクト URL に基づいて自動的に入力されます。 -
[OAuth トークンを作成して取得] クリックします。
Zendesk [OAuth 認証] ダイアログボックスが開きます。
-
ダイアログボックスで、 [許可] をクリックします。
OAuth アクセストークンは、Zendesk 接続を許可するために使用できるようになります。
-
ServiceNow インスタンスで、OAuth エンティティプロファイルスコープを追加します。
- 移動先 システム OAuth > アプリケーションレジストリー.
- Zendesk スポークのレコードを開きます。たとえば、[Zendesk OAuth] です。
- [OAuth エンティティプロファイル] タブで、デフォルトのレコードを開きます (例:Zendesk.OAuthProfile)。
-
これらの値を使用して新しい行を挿入します。
フィールド 値 OAuth エンティティスコープ users:write read OAuth スコープ write read