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 スコープです。

追加の構成:

• 更新トークン 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 スコープです。

追加の構成:

• 更新トークン 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. 左側のレールから [Integration Service] を選択します。
2. [ コネクタ] のリストから [ HTTP] を選択します。検索バーを使用してコネクタを検索することもできます。
3. [ HTTP に接続 ] ボタンを選択します。
4. [接続] 画面で、必要な詳細を入力します。
5. [接続] を選択します。
6. コネクションが追加されました。