---
title: "API7 Enterprise v3.2.15：多凭证认证 - API7.ai"
description: "API7 Enterprise v3.2.15では、コンシューマ認証と権限管理が最適化され、複数の認証情報と細かいアクセス制御戦略をサポートすることで、APIゲートウェイのセキュリティが強化されました。"
url: "https://api7.ai/ja/blog/api7-3.2.15-multi-credential-authentication"
---

[Blog](https://api7.ai/ja/blog)

[Products](https://api7.ai/ja/category/products)[Technology](https://api7.ai/ja/category/technology)[Ecosystem](https://api7.ai/ja/category/ecosystem)[Case Study](https://api7.ai/ja/category/usercase)[Team & Community](https://api7.ai/ja/category/community)

Search

⌘ + K

[Blog](https://api7.ai/blog)

Products

# API7 Enterprise v3.2.15：多凭证认证

[![Zhihuang Lin](https://github.com/oil-oil.png)](https://github.com/oil-oil)

[Zhihuang Lin](https://github.com/oil-oil)

September 18, 2024

[Products](https://api7.ai/category/products)

APIサービスがますます複雑化する中、IPアドレスや基本的なリクエストヘッダーにのみ依存する従来のアクセス制御方法では不十分となっています。[API7 Enterprise](https://api7.ai/enterprise)は「[Consumers](https://docs.api7.ai/enterprise/key-concepts/consumers)」という概念を導入し、開発者が特定のAPIルートやサービスにコンシューマーをバインドし、同じ認証プラグインを有効にすることができるようにしました。コンシューマーがリクエストを行う際、APIゲートウェイはリクエストに含まれる認証情報に基づいてコンシューマーを識別し、バインド関係に従って対応するアクセス制御ポリシーを適用します。

API7 Enterprise v3.2.15では、既存のコンシューマー認証メカニズムが強化されました。一般的に使用されるプラグインのインタラクションが最適化され、権限制御が改善され、プラグインごとに複数の認証情報がサポートされるようになりました。これにより、より柔軟な認証情報の管理とローテーションが可能になります。

## 最適化されたコンシューマー認証プラグインのインタラクション

単一の認証プラグイン内で複数の認証情報を簡単に追加できるようになりました。設定はコーディングから直感的なフォーム操作にアップグレードされ、設定プロセスがよりシンプルになりました。

![認証情報の追加](https://static.api7.ai/uploads/2024/09/13/cVsVoknY_credential-2.PNG?imageMogr2/format/webp)

現在、コンシューマーは以下の4つの認証方法を複数の認証情報でサポートしています。

### キー認証

キー認証は、キーベースの認証方法です。コンシューマーはリクエストに一意のキーを含める必要があり、このキーはクエリ文字列パラメータまたはHTTPヘッダーに含めることができます。リクエストを設定する際、コンシューマーはキーが正しくリクエストに含まれていることを確認する必要があります。

![キー認証の追加](https://static.api7.ai/uploads/2024/09/13/lYcVlBed_credential-3.PNG?imageMogr2/format/webp)

ルートまたはサービスの設定では、[Key Auth](https://docs.api7.ai/hub/key-auth)プラグインを有効にし、適切なルールを設定してリクエスト内のキーを検証する必要があります。ゲートウェイは、リクエストに期待されるキーが含まれているか、およびキーが設定と一致するかを確認します。キーの検証が成功すると、リクエストはバックエンドサービスへのアクセスを許可されます。失敗した場合、リクエストは拒否されます。

### 基本認証

基本認証は、ユーザー名とパスワードに基づく認証方法です。コンシューマーはリクエストにユーザー名とパスワードを含む認証情報を含める必要があります。通常、HTTPリクエストの`Authorization`ヘッダーにエンコードされますが、クエリ文字列パラメータを介して渡すこともできます（ただし、機密情報が漏洩する可能性があるため推奨されません）。コンシューマーは、リクエストを設定する際にエンコードされた認証情報が正しく含まれていることを確認する必要があります。

![基本認証情報の追加](https://static.api7.ai/uploads/2024/09/13/gSWNyGxx_credential-4.PNG?imageMogr2/format/webp)

ルートまたはサービスの設定では、[Basic Auth](https://docs.api7.ai/hub/basic-auth)プラグインを有効にし、適切なルールを設定して認証情報を検証する必要があります。ゲートウェイは、リクエストに`Authorization`ヘッダーが含まれているか、および基本認証の形式に従っているかを確認します。形式は`Basic <encoded-value>`で、`<encoded-value>`はユーザー名とパスワードをコロンで区切ったものをBase64エンコードした結果です。ゲートウェイはこの値をデコードし、デコードされたユーザー名とパスワードを設定情報と比較します。一致する場合、リクエストはバックエンドサービスへのアクセスを許可されます。一致しない場合、リクエストは拒否されます。

基本認証はユーザー名とパスワードを平文で送信するため、Base64エンコードされているだけで暗号化されていないため、高セキュリティのシナリオには適していません。

### JWT認証

[JWT認証](https://docs.api7.ai/hub/jwt-auth)は、JSON Web Token（JWT）に基づく認証方法です。コンシューマーはリクエストに有効なJWTトークンを含める必要があります。通常、`Authorization`ヘッダーにBearer `<token>`形式で含まれますが、必要に応じてクエリ文字列パラメータやクッキーに含めることもできます。コンシューマーは、リクエストを設定する際にJWTトークンの正確性と有効性を確認する必要があります。

JWT認証情報を追加する際、JWTトークンの生成に必要なキー要素を設定できます。これには、署名と検証に使用するキー（公開鍵または秘密鍵）、対称暗号化に使用するシークレット、使用するアルゴリズム（例：HMAC-SHA256またはRSA-SHA256）、およびトークンの有効期間を設定するための有効期限が含まれます。有効で期限切れでないトークンを保持しているコンシューマーのみが、保護されたバックエンドサービスにアクセスできます。

![JWT認証情報の追加](https://static.api7.ai/uploads/2024/09/13/cpt0AWpA_credential-5.PNG?imageMogr2/format/webp)

### HMAC認証

HMAC認証は、ハッシュベースのメッセージ認証コード（HMAC）に基づく認証方法です。コンシューマーはリクエストに対してHMAC値を生成する必要があります。通常、事前共有キーとリクエストの特定の部分（例：リクエストメソッド、URI、リクエストボディ）を使用して計算されます。このHMAC値はクエリ文字列パラメータまたはHTTPヘッダーに含めることができます。

リクエストを設定する際、コンシューマーは指定されたアルゴリズムと形式に従ってHMAC値を正しく生成し、リクエストに含める必要があります。具体的には、コンシューマーは既知のキーとリクエスト情報を使用して、ハッシュアルゴリズム（例：SHA-256）を使用してHMACを生成し、リクエストに追加します。

![HMAC認証情報の追加](https://static.api7.ai/uploads/2024/09/13/ihgZ5oqv_credential-6.png?imageMogr2/format/webp)

ルートまたはサービスの設定では、[HMAC Auth](https://docs.api7.ai/hub/hmac-auth)プラグインを有効にし、適切なルールを設定してリクエスト内のHMAC値を検証する必要があります。ゲートウェイは、リクエストにHMAC値が含まれているか、および同じ事前共有キーとアルゴリズムを使用してHMACを再計算し、その有効性を確認します。再計算されたHMACがリクエスト内の値と一致する場合、リクエストはバックエンドサービスへのアクセスを許可されます。

## 細かいコンシューマー権限ポリシー

認証情報の管理を最適化するだけでなく、コンシューマーの権限管理もさらに細かく調整しました。個々のコンシューマーレベルで権限を定義できるようになり、より細かいアクセス制御が可能になりました。認証情報の読み取りおよび書き込み権限は、コンシューマーの権限とは独立して制御されるようになり、より柔軟性が高まりました。

## まとめ

API7 Enterpriseの最新バージョンでは、コンシューマー認証と権限管理に大きな改善が導入されました。プラグインのインタラクションが最適化され、独立した認証情報管理が可能になり、複数の認証方法がサポートされ、コンシューマー権限戦略が洗練されました。これらの強化により、認証情報管理の柔軟性、システムのセキュリティ、および全体的なユーザーエクスペリエンスが向上しました。

今後のアップデートでは、追加の認証方法が導入され、認証情報管理がさらに洗練される可能性があり、より革新的な機能と改善されたユーザーエクスペリエンスが提供されるでしょう。

Tags:

[RBAC](https://api7.ai/tags/rbac)

[Permission Management](https://api7.ai/tags/permission-management)

[API7 Enterprise](https://api7.ai/tags/api7-enterprise)

Share article link

Share

Related Posts

[![API7 Enterprise v3.3.0 支持 API Portal](https://static.api7.ai/uploads/2024/12/26/y70oTHfl_api-portal-cover.png)](https://api7.ai/blog/api7-3.3.0-api-portal)

## [API7 Enterprise v3.3.0 支持 API Portal](https://api7.ai/blog/api7-3.3.0-api-portal)

[![API7 Enterprise v3.2.16.4 支持 Webhook/电子邮件警报通知](https://static.api7.ai/uploads/2024/11/14/MZsGTMyQ_alert.png)](https://api7.ai/blog/api7-3.2.16.4-supports-email-webhook-alert-notification)

## [API7 Enterprise v3.2.16.4 支持 Webhook/电子邮件警报通知](https://api7.ai/blog/api7-3.2.16.4-supports-email-webhook-alert-notification)

Table of Contents

- [最適化されたコンシューマー認証プラグインのインタラクション](#%E6%9C%80%E9%81%A9%E5%8C%96%E3%81%95%E3%82%8C%E3%81%9F%E3%82%B3%E3%83%B3%E3%82%B7%E3%83%A5%E3%83%BC%E3%83%9E%E3%83%BC%E8%AA%8D%E8%A8%BC%E3%83%97%E3%83%A9%E3%82%B0%E3%82%A4%E3%83%B3%E3%81%AE%E3%82%A4%E3%83%B3%E3%82%BF%E3%83%A9%E3%82%AF%E3%82%B7%E3%83%A7%E3%83%B3)

  - [キー認証](#%E3%82%AD%E3%83%BC%E8%AA%8D%E8%A8%BC)
  - [基本認証](#%E5%9F%BA%E6%9C%AC%E8%AA%8D%E8%A8%BC)
  - [JWT認証](#jwt%E8%AA%8D%E8%A8%BC)
  - [HMAC認証](#hmac%E8%AA%8D%E8%A8%BC)

- [細かいコンシューマー権限ポリシー](#%E7%B4%B0%E3%81%8B%E3%81%84%E3%82%B3%E3%83%B3%E3%82%B7%E3%83%A5%E3%83%BC%E3%83%9E%E3%83%BC%E6%A8%A9%E9%99%90%E3%83%9D%E3%83%AA%E3%82%B7%E3%83%BC)

- [まとめ](#%E3%81%BE%E3%81%A8%E3%82%81)

## Related Posts

[![API7 Enterprise 3.2.14.4：精细化权限管理的权限边界](https://static.api7.ai/uploads/2025/02/13/L4wPiOVN_3.2.14.4-permission-boundaries.png)](https://api7.ai/ja/blog/api7-3.2.14.4-policy-permission-and-boundary)

Products

August 15, 2024

#### [API7 Enterprise 3.2.14.4：精细化权限管理的权限边界](https://api7.ai/ja/blog/api7-3.2.14.4-policy-permission-and-boundary)

API7 Enterprise 3.2.14.4 引入了权限边界功能，旨在帮助企业实现更精细的用户权限管理，从而提升系统的安全性和控制能力。

[RBAC](https://api7.ai/tags/rbac)

[Permission Management](https://api7.ai/tags/permission-management)

[API7 Enterprise](https://api7.ai/tags/api7-enterprise)

[![API7 Enterprise v3.5.0：マルチアップストリーム構成](https://static.api7.ai/uploads/2025/02/19/mQ8cStKu_multi-upstream-configuration.png)](https://api7.ai/ja/blog/api7-3.5.0-mutli-upstream-for-traffic-management)

Products

February 19, 2025

#### [API7 Enterprise v3.5.0：マルチアップストリーム構成](https://api7.ai/ja/blog/api7-3.5.0-mutli-upstream-for-traffic-management)

API7 Enterprise v3.5.0では、柔軟で信頼性の高いトラフィック管理を実現するためのマルチアップストリーム設定が導入されました。

[Traffic Managment](https://api7.ai/tags/traffic-managment)

[API7 Enterprise](https://api7.ai/tags/api7-enterprise)

[![API7 Enterprise v3.4.0：通过SNI简化证书管理](https://static.api7.ai/uploads/2025/02/13/Q7IIQt7d_sni-certificate-management.png)](https://api7.ai/ja/blog/api7-3.4.0-sni-certificate-management)

Products

February 13, 2025

#### [API7 Enterprise v3.4.0：通过SNI简化证书管理](https://api7.ai/ja/blog/api7-3.4.0-sni-certificate-management)

API7 Enterprise v3.4.0では、直感的で効率的な証明書管理を実現するためのSNIリソース管理機能が導入されました。

[Certificate Management](https://api7.ai/tags/certificate-management)

[API7 Enterprise](https://api7.ai/tags/api7-enterprise)
