ZendeskをOktaと統合する
このアプリをOktaと統合するには、ZendeskとのAPI統合を有効にし、使用するプロビジョニング機能を選択する必要があります。スキーマ検出を使用して、ユーザープロファイルに属性を追加できます。
注:
Zendeskではすべてのサードパーティープロビジョニング統合にOAuth 2.0が必要です。OktaはグローバルなOAuthクライアントを使用して、管理者資格情報を保存することなく、Zendesk環境に安全に接続できます。この変更はプロビジョニングにのみ適用されます。SAML/ OIDCシングルサインオン(SSO)は影響を受けません。
開始する前の確認事項
- Zendeskの管理者ロールがある。
- Oktaのorg管理者またはアプリ管理者ロールがある。
- orgにZendeskアプリが統合されている。「既存のアプリ統合を追加する」を参照してください。
Zendesk OAuth権限
認証時にZendeskは、ZendeskアカウントへのOktaアクセスを付与するよう求めます。Oktaでは、プロビジョニングライフサイクルを管理するために次のOAuthスコープが必要です。
read:Oktaが既存のユーザー、グループ、スキーマ属性を読み取れるようにします。users:write:Oktaがユーザーを作成・更新・非アクティブ化できるようにします。groups:write:Oktaがグループメンバーシップを管理できるようにします。
API統合を有効にし、プロビジョニング機能を選択する
-
Admin Consoleで、に移動します。
- Zendeskアプリ統合を選択します。
- プロビジョニング(Provisioning)タブに移動します。注:
Zendesk統合を以前にAPIトークンまたはユーザー名とパスワードで構成していた場合は、このタブに廃止バナーが表示されます。以下の認証手順に進むと、接続がOAuth 2.0に移行されます。既存のBasic認証資格情報は、認証が完了するまではフォールバックとして残ります。
- API統合を構成(Configure API Integration)をクリックし、API統合を有効化(Enable API Integration)を選択します。
- Zendeskで認証する(Authenticate with Zendesk)をクリックします。
- Zendesk管理者アカウントにサインインし、Oktaアクセスを許可するための同意画面を承認します。
- インポートするユーザーロール(User Roles to Import)を選択します。すべてのユーザー(All Users)または管理者とエージェントのみ(Only Admins and Agents)のいずれかを選択します。
- インポート中に非アクティブなユーザーを無視する場合は、一時停止されたユーザーをインポートしない(Don't import suspended users)を選択します。
- グループをインポートする(Import Groups)を選択してOktaにグループをインポートします。
- 任意。API資格情報をテスト(Test API Credentials)をクリックして接続を検証します。
- 保存(Save)をクリックします。
- 任意。以下の手順で、OktaをZendeskプロビジョニング設定に変更します。
- プロビジョニング(Provisioning)タブに移動します。
- 設定(Settings)でアプリへ(To App)を選択します。
- 有効化するプロビジョニング機能を選択します。
- 保存(Save)をクリックします。
これで、ユーザーやグループをZendeskアプリ統合に割り当てられるようになります。
ユーザープロファイルに属性を追加する
Zendeskは属性を追加するためのスキーマ検出をサポートします。Oktaのユーザープロファイルに属性を追加するには、次の手順をすべて行います。
-
Admin Consoleでに進みます。
- アプリ(Apps)フィルターを選択してから、Zendeskアプリ統合を見つけて選択します。
- 現在の属性のリストを確認します。その他の属性を追加するには、属性を追加(Add Attribute)をクリックします。拡張属性のリストが表示されます。
- 追加する属性の情報を入力します。別の属性を追加するには、保存(Save)または保存して別のものを追加(Save and Add Another)をクリックします。
これらの新しい属性を、OktaとZendesk間のインポートとプッシュに利用できるようになりました。