コネクタービルダーの認可ドキュメント
認可ヘルプトピックには、ユーザーが接続を作成・認証する上で役立つ、あらゆる関連情報を盛り込む必要があります。
作成者のコネクターをユーザーが初めてフローに追加する際に、Okta Workflowsはユーザーに接続の構成を求めます。この接続は、ユーザーのアカウントまたは環境の検証に使用されます。
前提条件
前提条件セクションには、接続の構成前にユーザーに求められるあらゆる事項を指定します。たとえば、APIキーを生成する、またはOAuthアプリ統合を構成する必要があるとします。例:
サンプル:APIトークンを生成する
APIへの認証は、インスタンスレベルのベアラートークンを介して制御されます。トークンを生成するには:
-
ログインして設定(Settings)をクリックします。
-
アクセス(Access)タブをクリックします。
-
インスタンスに固有のAPI URLを特定します。
-
追加(Add)をクリックしてAPIキーを作成します。
-
APIトークンの名前を名前(Name)に指定します。
-
保存(Save)をクリックします。
-
APIトークンが提供されるダイアログで、可視性の記号をクリックしてAPIトークンを表示します。
-
コピー(Copy)をクリックしてAPIトークンをクリップボードにコピーします。
-
閉じる(Close)をクリックします。
接続を構成する
認証トピックには、サービスとの接続の作成方法を盛り込む必要があります。例:
サンプル:接続を作成する
-
接続(Connections)ページの新規接続(New Connection)をクリックします。
-
新規接続(New Connection)ダイアログの接続ニックネーム(Connection Nickname)に文字列を追加します。これは、複数の接続の作成してチームで共有する場合に便利です。
-
前提条件セクションで作成したAPIトークンをAPIトークン(API Token)フィールドに貼り付けます。
-
作成(Create)をクリックします。
サポートされるスコープ
OAuthまたはトークンベースのその他の認証向けに、コネクターの使用に必要なスコープのリストを盛り込む必要があります。スコープのセットアップに必要なものがあれば、その詳細を前提条件または構成セクションに盛り込みます。例:
サンプル:サポートされているスコープ
-
https://www.googleapis.com/auth/userinfo.profile
-
https://www.googleapis.com/auth/userinfo.email
-
https://www.googleapis.com/auth/gmail.settings.basic
例
参考情報については、コネクタービルダーの認可トピックを参照してください。
次の手順