Content last updated 2026-05-26

プロビジョニング

Zendesk のユーザープロビジョニングに関するドキュメント

このドキュメントでは、Zendesk におけるエージェントのプロビジョニングおよびデプロビジョニングのプロセスについて詳述します。

ロールベースのエンタイトルメント

GitLab で誰かが業務を開始してから 2 日後、そのロールベースのエンタイトルメントに基づいてアクセスリクエスト Issue が生成されます。リクエスト自体に基づいて手動でユーザーをプロビジョニングします。

これを行うには、以下が必要です。

  1. Zendesk にユーザーを作成(使用するロールはロールベースのエンタイトルメントのアクセスリクエスト Issue に含まれているはずです)。グループやその他の設定が正確であることを確認してください(アクセスリクエスト Issue を参照)。ユーザー作成の詳細については、エージェントを手動で作成するを参照してください。
  2. 必要な場合は Okta で適切なアプリを関連付け(詳細については Okta 経由でアプリを割り当てるを参照)。

完了したら、アクセスリクエスト Issue 内の項目をチェックオフします。

特別リクエスト

ロールベースのエンタイトルメントに関係しない、いずれかの Zendesk インスタンス上でのプロビジョニングに関する特別リクエスト Issue は、アクセスリクエスト Issue 経由で行う必要があります。続行するには Zendesk システムオーナーの承認が必要であることに注意してください。

プロビジョニングのタイミングで何をすべきかについては、ロールベースのエンタイトルメントを参照してください。

Zendesk Global ライトエージェント

これは、依頼者が Lumos 経由で依頼することで処理されます。これにより、Light Agent Provisioning プロジェクトに CI/CD パイプラインが作成されます。

これは bin/process_via_lumos スクリプトをトリガーし、以下を行います。

  1. 依頼者のメールが gitlab.com ドメインを持っているかを確認
    • 持っていない場合は、続行しません
  2. メールが現在 Zendesk のユーザーで使用中かを確認
  3. ユーザーが存在する場合、すでにエージェントになっているかを確認
    • すでにエージェントである場合は、その旨のメッセージを出力して続行しません
  4. 必要なメタデータを持つエージェントとしてユーザーを作成または更新するアクションを実行

専門化された Zendesk Global ライトエージェント

専門化されたライトエージェントのグループは、特定のタイプの内部リクエストを提出することが許可されています。これらのエージェントは、チームに基づいて特定のタグの追加または削除が必要です。

チーム必要なタグ
Partner Supportpartner_support_agent
Order Managementorder_management_team
OEM Managementoem_management_team

依頼されるのは、そのタグの追加または削除のみとなります(そしてアクセスリクエスト Issue 経由でなければなりません)。

Zendesk US Government ライトエージェント

これらは技術スタックプロビジョナーが手動でプロビジョニングする必要があるため、アクセスリクエスト Issue が必要です。

受領され承認された後、プロセスは以下のように進みます。

  1. People チームのドロップダウンの下から Background Checks を選択して HelpLab リクエストを送信します。次のページで、What type of support do you need? ドロップダウンから Identity Verification または Other を選択し、以下のプロンプトを使用してリクエストを記入します。

    Greetings all!

    Can you verify if NAME is a US Citizen? They are requesting access to the US Government Zendesk instance via ISSUE which does require it.

    Thanks!

  2. アクセスリクエスト Issue に、米国市民権確認のため People チームに連絡したことをノートします。
  3. People チームの応答に応じて、次のアクションが変わります。
    • People チームが市民権を確認した場合:
      • Zendesk US Government インスタンスにライトエージェントを手動で作成
      • Okta で Zendesk US Government アプリを関連付け(詳細については Okta 経由でアプリを割り当てるを参照)
      • プロビジョニング済みであることを Issue に更新
    • People チームが市民権を確認できない場合:
      • アクセスリクエスト Issue に、市民権が確認できなかったため Issue がクローズされる旨をコメントします。People チームからの確認なしには、これ以上のアクションは取れません。

デプロビジョニング

時折、エージェントのデプロビジョニングを依頼されることがあります(これらのほとんどはオフボーディングタスクから来ます)。エージェントをデプロビジョニングするには、Zendesk でそのエージェントのページに移動し、以下を行います。

  • そのエージェントからアクティブなチケット(Closed 未満)の割り当てを解除(マネージャーに割り当て)
  • ユーザーに関連付けられた Support Team ファイルを削除(該当する場合)
  • Zendesk からユーザーを削除
  • 完了したら、デプロビジョニングを依頼している Issue で以下を実施
    • 依頼 Issue の対応するボックスをチェック

Okta 経由でアプリを割り当てる

Okta 経由でアプリを関連付けるには、対応する Google グループに対象者のメールをメンバーとして追加します。

対象者を削除する必要がある場合は、グループ内で見つけて Unassign オプションをクリックします。