HTTP 認証

前提条件

HTTP コネクタを使用してコネクションを作成するには、選択した認証の種類に必要な詳細情報を指定する必要があります。各認証の種類に必要な詳細については、以下のセクションをご覧ください。これらの詳細を取得する方法の詳細については、API プロバイダーのドキュメントをご覧ください。

UiPath ユーザー アクセス トークン

サポートされている UiPath サービスを介して接続を確立します。構成は不要です。

OAuth 2.0 の認可コード

以下の詳細情報を指定します。

• コネクション名 - このコネクションを識別するのに役立つわかりやすい名前です。
• ベース URL - API のベース URL (例:https://api.example.com)。
• クライアント ID - アプリの登録時に OAuth プロバイダーから提供される、アプリケーションの一意の識別子です。
• クライアント シークレット - OAuth プロバイダーから提供される、アプリケーションの機密シークレット キーです。
• 認可 URL - OAuth プロバイダーから提供される完全な認可エンドポイント URL です (例:https://login.example.com/oauth2/authorize)。
• トークン URL - OAuth プロバイダーが提供するアクセス トークンと交換される、認証コードまたは資格情報のトークン エンドポイントの URL です (例:https://login.example.com/oauth2/token)。
• スコープ - API プロバイダーや連携のニーズに基づいて必要な OAuth スコープです。

注:

OAuth アプリケーションを OAuth プロバイダーに登録する際は、 コールバック URL をコネクション作成ページに表示されている値に設定してください (例: Automation Cloud の https://cloud.uipath.com/provisioning_/callback )。

追加の構成:

• 更新トークン URL - OAuth プロバイダーから提供される更新トークンのエンドポイント URL です (例:https://example.com/docs/oauth/refresh)
• トークン失効 URL - OAuth プロバイダー (https://example.com/docs/oauth/revoke) から提供されるトークン失効エンドポイントの URL です。
• 更新間隔 - OAuth トークンの更新試行の合間の時間 (秒単位)。
• OAuth 基本ヘッダー - 有効化すると、OAuth トークンの交換時にクライアント ID とシークレットを基本認証ヘッダーとして送信できます。ほとんどのプロバイダーでは、これを有効化する必要があります。

PKCE を使用した OAuth 2.0 認可コード

以下の詳細情報を指定します。

• コネクション名 - このコネクションを識別するのに役立つわかりやすい名前です。
• ベース URL - API のベース URL (例:https://api.example.com)。
• クライアント ID - アプリの登録時に OAuth プロバイダーから提供される、アプリケーションの一意の識別子です。
• クライアント シークレット - OAuth プロバイダーから提供される、アプリケーションの機密シークレット キーです。
• 認可 URL - OAuth プロバイダーから提供される完全な認可エンドポイント URL です (例:https://login.example.com/oauth2/authorize)。
• トークン URL - OAuth プロバイダーが提供するアクセス トークンと交換される、認証コードまたは資格情報のトークン エンドポイントの URL です (例:https://login.example.com/oauth2/token)。
• スコープ - API プロバイダーや連携のニーズに基づいて必要な OAuth スコープです。

注:

OAuth アプリケーションを OAuth プロバイダーに登録する際は、 コールバック URL をコネクション作成ページに表示されている値に設定してください (例: Automation Cloud の https://cloud.uipath.com/provisioning_/callback )。

追加の構成:

• 更新トークン URL - OAuth プロバイダーから提供される更新トークンのエンドポイント URL です (例:https://example.com/docs/oauth/refresh)
• トークン失効 URL - OAuth プロバイダー (https://example.com/docs/oauth/revoke) から提供されるトークン失効エンドポイントの URL です。
• 更新間隔 - OAuth トークンの更新試行の合間の時間 (秒単位)。
• OAuth 基本ヘッダー - 有効化すると、OAuth トークンの交換時にクライアント ID とシークレットを基本認証ヘッダーとして送信できます。ほとんどのプロバイダーでは、これを有効化する必要があります。

OAuth 2.0 クライアント資格情報

以下の詳細情報を指定します。

• コネクション名 - このコネクションを識別するのに役立つわかりやすい名前です。
• ベース URL - API のベース URL (例:https://api.example.com)。
• クライアント ID - アプリの登録時に OAuth プロバイダーから提供される、アプリケーションの一意の識別子です。
• クライアント シークレット - OAuth プロバイダーから提供される、アプリケーションの機密シークレット キーです。
• トークン URL - OAuth プロバイダーが提供するアクセス トークンと交換される、認証コードまたは資格情報のトークン エンドポイントの URL です (例:https://login.example.com/oauth2/token)。
• スコープ - API プロバイダーや連携のニーズに基づいて必要な OAuth スコープです。

追加の構成:

• 更新間隔 - OAuth トークンの更新試行の合間の時間 (秒単位)。
• OAuth 基本ヘッダー - 有効化すると、OAuth トークンの交換時にクライアント ID とシークレットを基本認証ヘッダーとして送信できます。ほとんどのプロバイダーでは、これを有効化する必要があります。

OAuth 2.0 パスワード

以下の詳細情報を指定します。

• コネクション名 - このコネクションを識別するのに役立つわかりやすい名前です。
• ベース URL - API のベース URL (例:https://api.example.com)。
• ユーザー名 - 認証用のエンド ユーザーの資格情報のユーザー名です。
• パスワード - エンド ユーザーの認証用のパスワード資格情報です。
• クライアント ID - アプリの登録時に OAuth プロバイダーから提供される、アプリケーションの一意の識別子です。
• クライアント シークレット - OAuth プロバイダーから提供される、アプリケーションの機密シークレット キーです。
• 認可 URL - OAuth プロバイダーから提供される完全な認可エンドポイント URL です (例:https://login.example.com/oauth2/authorize)。
• トークン URL - OAuth プロバイダーが提供するアクセス トークンと交換される、認証コードまたは資格情報のトークン エンドポイントの URL です (例:https://login.example.com/oauth2/token)。
• スコープ - API プロバイダーや連携のニーズに基づいて必要な OAuth スコープです。

追加の構成:

• 更新トークン URL - OAuth プロバイダーから提供される更新トークンのエンドポイント URL です (例:https://example.com/docs/oauth/refresh)。
• トークン失効 URL - OAuth プロバイダー (https://example.com/docs/oauth/revoke) から提供されるトークン失効エンドポイントの URL です。
• 更新間隔 - OAuth トークンの更新試行の合間の時間 (秒単位)。
• OAuth 基本ヘッダー - 有効化すると、OAuth トークンの交換時にクライアント ID とシークレットを基本認証ヘッダーとして送信できます。ほとんどのプロバイダーでは、これを有効化する必要があります。

基本認証

以下の詳細情報を指定します。

• コネクション名 - このコネクションを識別するのに役立つわかりやすい名前です。
• ベース URL - API のベース URL (例:https://api.example.com)。
• ユーザー名 - API アカウントの資格情報のユーザー名です。
• パスワード - API アカウントのパスワード資格情報です。

追加の構成:

• 認証検証 API - 認証資格情報の検証に使用する相対パスを入力します (例:/api/v1/me、/user/profile、/auth/validate)。この API ルートは、資格情報が有効な場合に正常な応答を返す必要があります。

API キー

以下の詳細情報を指定します。

• コネクション名 - このコネクションを識別するのに役立つわかりやすい名前です。
• ベース URL - API のベース URL (例:https://api.example.com)。
• パラメーター名 - API で必要な API キー パラメーターの正確な名前です (例:X-API-Key、 api_key、 Authorization)。これは、選択内容に応じてヘッダー名またはクエリ パラメーター名として使用されます。
• 値 - API プロバイダーから提供された API キーの完全な値です。これは安全に保存され、認証に使用されます。

追加の構成:

• 追加先 - API キーを要求ヘッダーに追加するか、クエリ パラメーターとして追加するかを選択します。セキュリティを強化するためにヘッダーを使用することをお勧めします。
• 認証検証 API - 認証資格情報の検証に使用する相対パスを入力します (例:/api/v1/me、/user/profile、/auth/validate)。この API ルートは、資格情報が有効な場合に正常な応答を返す必要があります。

OAuth 2.0 JWT ベアラー

以下の詳細情報を指定します。

• コネクション名 - このコネクションを識別するのに役立つわかりやすい名前です。
• ベース URL - API のベース URL (例:https://api.example.com)。
• クライアント ID - アプリの登録時に OAuth プロバイダーから提供される、アプリケーションの一意の識別子です。
• クライアント シークレット - OAuth プロバイダーから提供される、アプリケーションの機密シークレット キーです。
• JWT Base64 エンコード キー - Base64 でエンコードされた秘密キーです。キーの生成とエンコードに関する API プロバイダーの指示に従っていることを確認します。
• 認可 URL - OAuth プロバイダーから提供される完全な認可エンドポイント URL です (例:https://login.example.com/oauth2/authorize)。
• トークン URL - OAuth プロバイダーが提供するアクセス トークンと交換される、認証コードまたは資格情報のトークン エンドポイントの URL です (例:https://login.example.com/oauth2/token)。
• スコープ - API プロバイダーや連携のニーズに基づいて必要な OAuth スコープです。

追加の構成:

• 更新トークン URL - OAuth プロバイダーから提供される更新トークンのエンドポイント URL です (例:https://example.com/docs/oauth/refresh)。
• トークン失効 URL - OAuth プロバイダー (https://example.com/docs/oauth/revoke) から提供されるトークン失効エンドポイントの URL です。
• 更新間隔 - OAuth トークンの更新試行の合間の時間 (秒単位)。
• OAuth 基本ヘッダー - 有効化すると、OAuth トークンの交換時にクライアント ID とシークレットを基本認証ヘッダーとして送信できます。ほとんどのプロバイダーでは、これを有効化する必要があります。

個人用アクセス トークン

以下の詳細情報を指定します。

• コネクション名 - このコネクションを識別するのに役立つわかりやすい名前です。
• ベース URL - API のベース URL (例:https://api.example.com)。
• トークン プレフィックス - トークンのプレフィックス (例:Bearer、 Token、 Basic)。これは、認可ヘッダーのトークンと組み合わされます。プレフィックスが不要な場合は、空のままにします。
• トークン - 個人用アクセス トークンの完全な値です。これは、認可ヘッダーのトークンの種類 (例:Bearer your-token-here)。

追加の構成:

• 認証検証 API - 認証資格情報の検証に使用する相対パスを入力します (例:/api/v1/me、 /user/profile、 /auth/validate)。この API ルートは、資格情報が有効な場合に正常な応答を返す必要があります。

HTTP 接続を追加する

1. 製品ランチャーから [Orchestrator] を選択します。

2. フォルダーを選択して [ コネクション ] タブに移動します。

3. [ コネクションを追加] を選択します。

4. コネクション作成ページを開くには、リストからコネクタを選択します。検索バーを使用してコネクタを検索できます。

5. [接続] 画面で、必要な詳細を入力します。

   For any secret-type field, you can select the menu next to the field and choose Use credential asset to reference an Orchestrator credential asset linked to an external vault instead of entering the value directly. For more information, see Use credential assets for connections.

6. [接続] を選択します。

7. コネクションが追加されました。