この手順は、アプリケーションに対してトークンを受け取り、Genesys Cloudにリクエストできるようにするアプリケーションプロバイダ向けです。 プラットフォーム API。トークンは、アプリがGenesys Cloudデータにアクセスするユーザー権限を表します。アプリがAPIエンドポイントへのリクエストを承認する必要がある場合に使用されます。Genesys Cloud Platform APIのリストについては、 APIリソース Genesys Cloud Developer Centerにあります。

1. クリック 管理者。
2. 下 統合クリック OAuth。

3. クリック クライアントを追加。[クライアントの詳細]タブが表示されます。

   

4. セット アプリ名 アプリのわかりやすい名前に。これは誰かが見たときに表示される名前です 承認する このOAuthクライアント。
5. （省略可能）にアプリの簡単な説明を入力します。 説明 ボックス。
6. 次に、このクライアントで作成されたトークンが期限切れになるまでの期間を設定します。デフォルトの期間を受け入れるか、300から172800秒の間の値を入力します。これにより、トークンの有効期間が最大2日以内に設定されます。

7. 下から選択してください 交付金の種類。付与タイプは、アプリケーションがアクセストークンを取得する方法を設定します。Genesys Cloudは、以下に示すOAuth 2認可付与タイプをサポートしています。 付与タイプ名をクリックすると、そのタイプに関する詳細情報が表示されます。Genesys Cloud Developer Centerです。

   • クライアント資格情報の付与：非ユーザーアプリケーション専用のシングルステップ認証プロセス（Windowsサービスやcronジョブなど）。クライアントアプリケーションは、アクセストークンと引き換えにOAuthクライアントの認証情報を提供します。この認証タイプはユーザーのコンテキストにはないため、ユーザー固有のAPI（例：GET / v2 / users / me）にアクセスすることはできません。

     SalesforceのGenesys Cloudにロールを割り当てる場合は、も参照してください。 Salesforce用Genesys CloudのOAuthクライアント権限.

   • コード許可付与：ユーザーがGenesys Cloudで認証し、クライアントアプリケーションが認証コードを返す2ステップ認証プロセス。クライアントアプリケーションはOAuthクライアントの認証情報を提供し、認証コードを使用してアクセストークンを取得します。認証されたAPI呼び出しを行うときにアクセストークンを使用できます。これは、最も安全なオプションであり、API要求がサーバー側で行われるWebサイト（ASP.NETやPHPなど）や、シンクライアントがユーザーを認証して認証コードをバックエンドサーバーに渡すデスクトップアプリケーションに最適です認証トークンと交換してAPI要求を行う。

   • 暗黙の付与（ブラウザ）: ユーザーがGenesys Cloudで認証し、クライアントアプリケーションがアクセストークンを直接返す、1ステップ認証プロセス。このオプションは、認証コードの付与よりもアクセストークンのセキュリティが低くなりますが、クライアントサイドのブラウザアプリケーション（JavaScriptなど）およびほとんどのデスクトップアプリケーション（例：NET WPF / WinFormsまたはJavaデスクトッププログラム）

   • SAML2 ベアラ: クライアントアプリケーションがベアラトークンを要求するためにSecurity Assertion Markup Language （ SAML ）（SAML2）アサーションを使用することができる認証プロセス。以下も参照してください。Genesys CloudシングルサインオンおよびIDプロバイダーソリューション.

     注意：単一のコード認証または暗黙の付与タイプをすべてのリージョンで使用できます。

8. 付与タイプに必要なパラメータを指定します。

   • 役割：選択した場合 クライアント資格情報、 クリック 役割 タブ。これにより、選択可能な役割のリストが開きます。OAuthクライアント統合でできることを決定するために、最低限の役割セットを割り当てます。
     

     注意：OAuthクライアントに役割を付与するには、それらの役割をプロファイルに割り当てる必要があります。

     

     また、各役割を 部門. Client Credential Grantの役割にどの部門を関連付けるべきかを決定します。すべてのClient Credential付与役割は、デフォルトでHome Divisionにスコープされています。これらの補助金を使用するアプリケーションおよびシステムが適切なデータにアクセスできるように、適切な部門に更新してください。クライアント資格情報の付与が3人目の相手 or 参加者によって提供されている場合は、3人目の相手 or 参加者に連絡して、付与の使用方法を理解し、役割の部門を適切に更新します。他の付与タイプがアクセス制御の影響を受けることはありません。

   • 許可されたリダイレクトURI（ 回線ごとに1つ、最大125）: これらは、後続のAPI呼び出しを認証するために後で使用されるアクセストークンと交換するために、許可コードがポストされるURIです。

   • 範囲：クライアント資格情報を除くすべての許可の種類には、スコープ設定があります。[スコープ]ボックスをクリックして、アプリで利用可能なスコープの一覧を表示します。ベストプラクティスとして、アプリに必要な最小限の範囲のみを選択してください。スコープについては、 OAuthスコープ デベロッパーセンターで。

9. クリック 保存する。Genesys Cloudは、クライアントIDとクライアントシークレット(トークン)を作成します。

これで、Genesys Cloud OAuthクライアントを使用する準備ができました。