未認証APIコレクション ​

APIプロキシコレクションを、未認証リクエストを受け入れるように設定し、アプリケーション、キー、またはトークンなしで任意の呼び出し元がそのエンドポイントにアクセスできるようにします。 デフォルトでは、Workato API platform上のすべてのエンドポイントに認証済みクライアントが必要です。

未認証コレクションを使用して、標準プロトコルで認証情報なしに到達可能であることが求められるエンドポイントを提供します。 最も一般的なケースは、/.well-known/openid-configurationなどのOpenID Connect（OIDC）検出ドキュメントです。クライアントアプリケーションはこれを取得して、プロバイダーの認可、トークン、ユーザー情報エンドポイント、および署名キー（JWKS）を自動検出します。 API platformでのOIDCの詳細については、OpenID Connectを参照してください。

未認証アクセスの仕組み ​

未認証アクセスはコレクションレベルの設定です。 APIプロキシコレクションで有効にすると、そのコレクション内のすべてのエンドポイントが認証情報なしのリクエストを受け入れ、Workatoはクライアントキーまたはトークンを確認しません。 この設定はコレクション全体に適用され、個々のエンドポイントには適用されません。

クライアントとアプリケーションはコレクションに引き続き存在しますが、未認証アクセスが有効になっている間はアクセスを制限しなくなります。 クライアント作成フローは変更されません。 この設定は、APIプロキシを非アクティブ化して再アクティブ化しても保持されます。

コレクションの未認証リクエストを許可する ​

未認証アクセスは、APIプロキシコレクションのコレクション詳細パネルから設定します。

APIプロキシコレクションの未認証リクエストを許可するには、次の手順を実行します。

未認証リクエストを拒否する ​

コレクションの認証を復元するには、次の手順を実行します。

未認証コレクションのクライアントアクセス ​

コレクションが未認証リクエストを受け入れる場合、どの呼び出し元でも認証情報なしでエンドポイントにアクセスできるため、コレクションのClientsタブに一覧表示されているクライアントはアクセスを制限できません。

API collectionsページでは、未認証リクエストを受け入れるコレクションのカードに、クライアントアクセス数の代わりにAuthentication not requiredインジケーターが表示されます。

未認証エンドポイントを呼び出す ​

コンシューマーは、未認証コレクション内のエンドポイントを、コレクションのURLを通じて、Authorizationヘッダー、キー、またはトークンなしで呼び出します。 例:

curl https://api.example.com/oidc/.well-known/openid-configuration

コレクションが未認証リクエストを受け入れ、プロキシがアクティブな場合、Workatoはレスポンスを返します。

レスポンスキャッシュ ​

レスポンスキャッシュは、未認証コレクション内のエンドポイントでも引き続き使用できます。 通常どおり、各エンドポイントのキャッシュを有効にします。 詳細については、APIエンドポイントキャッシュを参照してください。

制限事項 ​

未認証APIコレクションには次の制限があります。

• 未認証アクセスはAPIプロキシコレクションでのみ使用できます。 APIレシピコレクションとAI gatewayコレクションはサポートされていません。
• レート制限やリクエスト制限など、APIアクセスポリシーは未認証コレクションには適用されません。
• 許可およびブロックされたIPルールは未認証コレクションには適用されません。