この手順は、のためにあるアプリケーションそのアプリは、それはへのリクエスト加えることができ、トークンを受信したいプロバイダPureCloud プラットフォーム API。トークンは、PureCloudデータにアクセスするためのアプリに対するユーザーの許可を表します。アプリがAPIエンドポイントへのリクエストを承認する必要がある場合に使用されます。PureCloud プラットフォーム APIのリストを見るには、 APIリソース PureCloud 開発者センター 。

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

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

   

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

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

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

     SalesforceにPureCloudの役割を割り当てる場合は、以下も参照してください。 Salesforceに対するPureCloudのOAuthクライアント権限。

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

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

   • SAM2ベアラ：クライアントアプリケーションがベアラトークンを要求するためにSecurity Assertion Markup Language （ SAML ）（SAML2）アサーションを使用することができる認証プロセス。また見なさい： PureCloudシングルサインオンおよびIDプロバイダソリューション。

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

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

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

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

     

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

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

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

9. クリック 保存する。PureCloudは、クライアントIDとクライアントシークレット（トークン）を作成します。

PureCloud OAuthクライアントを使用する準備が整いました。