---
title: "API7 Enterprise 3.2.14.4：精细化权限管理的权限边界 - API7.ai"
description: "API7 Enterprise 3.2.14.4 引入了权限边界功能，旨在帮助企业实现更精细的用户权限管理，从而提升系统的安全性和控制能力。"
url: "https://api7.ai/ja/blog/api7-3.2.14.4-policy-permission-and-boundary"
---

[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 3.2.14.4：精细化权限管理的权限边界

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

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

August 15, 2024

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

[API7 Enterprise](https://api7.ai/enterprise) v3.2.14.4が正式にリリースされ、企業におけるより細かいユーザー権限管理のニーズに対応するため、パーミッション境界（Permission Boundary）が導入されました。

### パーミッション境界とは？

パーミッション境界とは、その名の通り、ユーザーが持つことができる権限の最大範囲を定義する「権限の壁」のようなものです。これは、ユーザーやロールがシステム内で実行できるアクションを制限するために使用されます。その主な目的は、システムのセキュリティを強化し、権限の悪用を防ぐことです。この「壁」を設定することで、ユーザーが自分の責任範囲内でのみ操作を行い、権限を超えてシステム内のデータにアクセスしたり変更したりできないようにすることができます。

パーミッション境界は、システム内の既存の権限ポリシーを再利用することも、新たに権限ポリシーを作成することもできます。ユーザーにパーミッション境界が割り当てられると、そのユーザーの権限は制限されますが、直接的に権限が付与されるわけではありません。

### 例

例えば、すべてのゲートウェイグループにわたるサービスの操作および閲覧権限を付与する権限ポリシーを作成し、このポリシーをユーザーTomのパーミッション境界として割り当てたとします。

```
{
  "statement": [
    // すべてのゲートウェイグループにわたる閲覧権限
    {
      "effect": "allow",
      "resources": [
        "arn:api7:gateway:gatewaygroup/<.*>"
      ],
      "actions": [
        "<.*>Get<.*>"
      ]
    },
    // すべてのゲートウェイグループにわたるサービス操作権限
    {
      "effect": "allow",
      "resources": [
        "*"
      ],
      "actions": [
        "arn:api7:gateway:gatewaygroup/<.*>/publishedservice/<.*>"
      ]
    }
  ]
}
```

この場合、Tomの最大権限はこの権限ポリシー内に制限されます。パーミッション境界が設定されているからといって、Tomがすでにこれらの権限を持っているわけではありません。次に、Tomに以下の権限ポリシーを持つロールを割り当てます。

```
{
  "statement": [
    // すべてのゲートウェイグループにわたる閲覧権限
    {
      "effect": "allow",
      "resources": [
        "arn:api7:gateway:gatewaygroup/<.*>"
      ],
      "actions": [
        "<.*>Get<.*>"
      ]
    },
    // すべてのゲートウェイグループにわたるサービス操作権限
    {
      "effect": "allow",
      "resources": [
        "arn:api7:gateway:gatewaygroup/<.*>/publishedservice/<.*>"
      ],
      "actions": [
        "<.*>"
      ]
    },
    // カスタムプラグインの操作権限
    {
      "effect": "allow",
      "resources": [
        "arn:api7:gateway:gatewaysetting/*"
      ],
      "actions": [
        "gateway:<.*>CustomPlugin<.*>"
      ]
    }
  ]
}
```

Tomはすべてのゲートウェイグループにわたるサービス操作、閲覧、およびカスタムプラグインの操作権限を付与されていますが、カスタムプラグインの編集権限を持っていないことに気づくでしょう。これは、Tomに対してパーミッション境界が設定されているためです。パーミッション境界がカスタムプラグインに関連する権限を含むように調整されない限り、境界を超える追加の権限は無効です。

## パーミッション境界機能の使用方法

### 権限ポリシーの作成

パーミッション境界は、システム内の権限ポリシーを直接再利用できます。ユーザーにパーミッション境界を割り当てる前に、権限ポリシーを作成する必要があります。システムの組織メニューで「権限ポリシー」をクリックし、リストページに移動します。

![権限ポリシー](https://static.api7.ai/uploads/2024/08/15/DgTlFm2j_1-permission-policy.png?imageMogr2/format/webp)

次に、リストの右上にある「権限ポリシーを追加」をクリックして、作成フォームに移動します。

![ポリシーを追加](https://static.api7.ai/uploads/2024/08/15/Nx4D2iZT_2-add-policy.png?imageMogr2/format/webp)

フォームに権限ポリシーの基本情報を入力し、対応するポリシーステートメントを設定して権限ポリシーを作成します。理論的には、同じ権限ポリシーを複数のロールに関連付け、複数のユーザーのパーミッション境界として使用できますが、この方法は推奨されません。

![ポリシーを設定](https://static.api7.ai/uploads/2024/08/15/Pds9yFIo_3-configure-policy.png?imageMogr2/format/webp)

権限ポリシーの概念的な紹介については、記事「[*API7 Enterprise 3.4.14の新機能: IAMによる細かいアクセス制御*](https://api7.ai/blog/api7-3.2.14-iam-finer-access-control)」を参照してください。一般的なポリシー設定例については、ドキュメント「[*権限ポリシーの例*](https://docs.api7.ai/enterprise/reference/permission-policy-examples)」を参照してください。リソースとアクションの取り得る値と対応するAPIについては、ドキュメント「[*権限ポリシーのアクションとリソース*](https://docs.api7.ai/enterprise/reference/permission-policy-action-and-resource)」を参照してください。

### パーミッション境界の割り当て

権限ポリシーを作成した後、パーミッション境界を割り当てることができます。組織メニューで「ユーザー」をクリックし、ユーザーリストページに移動します。

![ユーザー](https://static.api7.ai/uploads/2024/08/15/B0Dq7z5j_4-users.png?imageMogr2/format/webp)

新しいユーザーを招待する際に、直接パーミッション境界を割り当てることができます。招待フォームには、パーミッション境界の新しいフィールドが含まれており、ユーザーがシステムにログインすると、このパーミッション境界がデフォルトで割り当てられます。

![境界を設定](https://static.api7.ai/uploads/2024/08/15/VeGC5C7Y_5-set-boundary.png?imageMogr2/format/webp)

既存のユーザーについては、ユーザー詳細ページのパーミッション境界の編集アイコンをクリックして、パーミッション境界を設定できます。

![パーミッション境界を編集](https://static.api7.ai/uploads/2024/08/15/7nI7d6Mg_6-edit-permission-boundary.png?imageMogr2/format/webp)

ユーザーの権限を設定する際、特定の操作権限に`permission_boundaries`条件を追加することができます。例えば、`iam:InviteUser`（ユーザー招待）や`iam:UpdateUserBoundary`（ユーザーのパーミッション境界更新）のアクションに、`permission_boundaries`条件を追加することで、さらに細かい権限制御を行うことができます。

この条件下では、ユーザーに設定する必要がある権限ポリシーのIDを指定できます。これにより、新しいユーザーを招待したり、他のユーザーのパーミッション境界を更新したりする際に、システムはこれらの事前設定されたルールに基づいて適切なパーミッション境界を強制的に割り当てます。

以下は、これを実現する方法を示す例です。

```
{
  "statement": [
    {
      "effect": "allow",
      "resources": ["arn:api7:iam:user/<.*>"],
      "actions": [
        "iam:InviteUser",
        "iam:UpdateUserBoundary"
      ],
      "conditions": {
        "permission_boundaries": {
          "type": "AllOfStrings",
          "options": [
            "d3698967-1d28-4e37-b5e7-ef00a93304cc",
            "f863a233-f732-4af0-bb21-3fbe4013be69"
          ]
        }
      }
    }
  ]
}
```

### パーミッション境界マッピング

システム内で特定のパーミッション境界を直接設定するだけでなく、API7 Enterpriseは「パーミッション境界マッピング」もサポートしており、IdP（Identity Provider）でのユーザーのIDと権限に基づいて、対応するパーミッション境界を自動的に割り当てることができます。組織設定ページで「ログインオプションを追加」をクリックします。どのプロバイダーを選択しても、設定フォームの下部に「パーミッション境界マッピング」スイッチが追加されます。これを有効にすると、パーミッション境界マッピングを設定できます。

![パーミッション境界マッピング](https://static.api7.ai/uploads/2024/08/15/zqXTxTPO_7-permission-boundary-mapping.png?imageMogr2/format/webp)

- **権限ポリシー**: これはAPI7 Enterpriseで定義された権限ポリシーリソースで、ユーザーのアクセスと操作範囲を制御するために使用されます。パーミッション境界マッピングでは、外部IdPからの設定をこれらのパーミッション境界にマッピングして、ユーザーがログイン時に適切なパーミッション境界を割り当てることができます。
- **マッピングされたパーミッション境界属性**: IdPから返されるユーザーのパーミッション境界情報の識別子で、IdPの応答内でユーザーのパーミッション境界データを特定するために使用されます。例えば、「role」や「groups」などの属性名を指定すると、システムはこの属性名に基づいてIdPの応答からパーミッション境界の値を抽出します。
- **操作**: IdPのパーミッション境界属性からパーミッション境界値をマッチングするために使用される方法です。完全一致、部分一致、配列内の一致など、さまざまな方法がサポートされています。IdPがパーミッション境界値の文字列配列を返す場合、「配列内の完全一致」を選択して一致を見つけることができます。
- **マッピングされたパーミッション境界値**: IdP内でユーザーのパーミッション境界を表す具体的な値です。

### まとめ

全体的に見て、パーミッション境界はシステムのセキュリティを確保し、権限の悪用を防ぐための重要なツールです。ユーザーの権限範囲を明確に定義することで、重要なシステムリソースを不正アクセスから保護し、各ユーザーが許可された範囲内でのみ操作できるようにすることができます。複雑なシステム環境では、パーミッション境界を効果的に活用することで、企業のデータセキュリティに強力な保護を提供します。

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

- - [パーミッション境界とは？](#%E3%83%91%E3%83%BC%E3%83%9F%E3%83%83%E3%82%B7%E3%83%A7%E3%83%B3%E5%A2%83%E7%95%8C%E3%81%A8%E3%81%AF)
  - [例](#%E4%BE%8B)

- [パーミッション境界機能の使用方法](#%E3%83%91%E3%83%BC%E3%83%9F%E3%83%83%E3%82%B7%E3%83%A7%E3%83%B3%E5%A2%83%E7%95%8C%E6%A9%9F%E8%83%BD%E3%81%AE%E4%BD%BF%E7%94%A8%E6%96%B9%E6%B3%95)

  - [権限ポリシーの作成](#%E6%A8%A9%E9%99%90%E3%83%9D%E3%83%AA%E3%82%B7%E3%83%BC%E3%81%AE%E4%BD%9C%E6%88%90)
  - [パーミッション境界の割り当て](#%E3%83%91%E3%83%BC%E3%83%9F%E3%83%83%E3%82%B7%E3%83%A7%E3%83%B3%E5%A2%83%E7%95%8C%E3%81%AE%E5%89%B2%E3%82%8A%E5%BD%93%E3%81%A6)
  - [パーミッション境界マッピング](#%E3%83%91%E3%83%BC%E3%83%9F%E3%83%83%E3%82%B7%E3%83%A7%E3%83%B3%E5%A2%83%E7%95%8C%E3%83%9E%E3%83%83%E3%83%94%E3%83%B3%E3%82%B0)
  - [まとめ](#%E3%81%BE%E3%81%A8%E3%82%81)

## Related Posts

[![API7 Enterprise v3.2.15：多凭证认证](https://static.api7.ai/uploads/2025/02/13/UwLtPsLt_3.2.15-multi-credential-authentication.png)](https://api7.ai/ja/blog/api7-3.2.15-multi-credential-authentication)

Products

September 18, 2024

#### [API7 Enterprise v3.2.15：多凭证认证](https://api7.ai/ja/blog/api7-3.2.15-multi-credential-authentication)

API7 Enterprise v3.2.15では、コンシューマ認証と権限管理が最適化され、複数の認証情報と細かいアクセス制御戦略をサポートすることで、APIゲートウェイのセキュリティが強化されました。

[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)
