コネクタービルダーの認可ドキュメント

認可ヘルプトピックには、ユーザーが接続を作成・認証する上で役立つ、あらゆる関連情報を盛り込む必要があります。

作成者のコネクターをユーザーが初めてフローに追加する際に、Okta Workflowsはユーザーに接続の構成を求めます。この接続は、ユーザーのアカウントまたは環境の検証に使用されます。

前提条件

前提条件セクションには、接続の構成前にユーザーに求められるあらゆる事項を指定します。たとえば、APIキーを生成する、またはOAuthアプリ統合を構成する必要があるとします。例:

サンプル:APIトークンを生成する

APIへの認証は、インスタンスレベルのベアラートークンを介して制御されます。トークンを生成するには:

  1. ログインして設定(Settings)をクリックします。

  2. アクセス(Access)タブをクリックします。

  3. インスタンスに固有のAPI URLを特定します。

  4. 追加(Add)をクリックしてAPIキーを作成します。

  5. APIトークンの名前を名前(Name)に指定します。

  6. 保存(Save)をクリックします。

  7. APIトークンが提供されるダイアログで、可視性の記号をクリックしてAPIトークンを表示します。

  8. コピー(Copy)をクリックしてAPIトークンをクリップボードにコピーします。

  9. 閉じる(Close)をクリックします。

接続を構成する

認証トピックには、サービスとの接続の作成方法を盛り込む必要があります。例:

サンプル:接続を作成する

  1. 接続(Connections)ページの新規接続(New Connection)をクリックします。

  2. 新規接続(New Connection)ダイアログの接続ニックネーム(Connection Nickname)に文字列を追加します。これは、複数の接続の作成してチームで共有する場合に便利です。

  3. 前提条件セクションで作成したAPIトークンをAPIトークン(API Token)フィールドに貼り付けます。

  4. 作成(Create)をクリックします。

サポートされるスコープ

OAuthまたはトークンベースのその他の認証向けに、コネクターの使用に必要なスコープのリストを盛り込む必要があります。スコープのセットアップに必要なものがあれば、その詳細を前提条件または構成セクションに盛り込みます。例:

サンプル:サポートされているスコープ

  • https://www.googleapis.com/auth/userinfo.profile

  • https://www.googleapis.com/auth/userinfo.email

  • https://www.googleapis.com/auth/gmail.settings.basic

参考情報については、コネクタービルダーの認可トピックを参照してください。

  • Boxコネクターの認可

  • Freshserviceコネクターの認可

次の手順

コネクタービルダー提出ドキュメント

コネクタービルダー提出ドキュメント