Logo
Logo
CTRLK

共有コンポーネント

CPaaS X セットアップを保護


CPaaS X は、各エンティティのデータをプラットフォーム レベルで分離します。顧客またはサービスに API アクセスを提供する場合、スコープ付き API キーによって制御レイヤーが追加されます。アカウント全体のアクセスを提供する標準の API キーとは異なり、スコープ付き API キーは、使用を特定のアプリケーションまたはエンティティに制限します。これにより、きめ細かなアクセス制御が可能になり、資格情報が侵害された場合の影響が制限されます。



標準キーとスコープ付きAPIキー [#standard-vs-scoped-api-keys]

次の表は、標準キーとスコープ付きAPIキーを比較したものです。


ディメンション標準 APIキースコープ付き APIキー
アプリケーションアクセスすべてのアプリケーション特定のアプリケーション
エンティティ アクセスすべてのエンティティ特定のエンティティ/エンティティ
エンドポイントアクセスすべてのエンドポイント許可されたエンドポイントのみ
チャネルアクセス全チャネル許可されたチャネルのみ
侵害された場合アカウント全体が危険にさらされている影響を受けるスコープのみ


スコープ付き API キーを使用する場合 [#when-to-use-scoped-api-keys]

Customer access

顧客アクセス

各顧客にエンティティ スコープのキーを付与して、顧客が自分のデータにのみアクセスできるようにします。たとえば、customer-a は、エンティティのみを対象とするキーを取得します。

Team access control

チーム アクセス制御

異なるチームは、割り当てられたリソースにのみアクセスします。マーケティングはマーケティング エンティティ キーを取得し、サポートはサポート エンティティ キーを取得します。

Environment separation

環境分離

「運用」環境と「ステージング」環境のアプリケーションスコープのキー。各キーは、割り当てられたアプリケーションにのみアクセスできます。



APIキースコープのディメンション [#api-key-scope-dimensions]

API キーは、3 つの次元にスコープを設定できます。それらのいずれかを組み合わせることができます。

Application and entity scope

アプリケーション/エンティティ

スコープなし (すべて)、アプリケーション スコープ (1 つのアプリケーション、そのすべてのエンティティ)、エンティティ スコープ (1 つのエンティティ)、またはアプリケーション + エンティティ スコープ (1 つのアプリケーション内の 1 つのエンティティ)。

Endpoint access

エンドポイントアクセス

メッセージング (メッセージの送信)、レポート (配信レポートと分析)、ログ (メッセージ ログとイベント履歴)、プロビジョニング (リソースと構成の管理)。

Channel scope

チャネル

すべてのチャネル (無制限)、または特定のチャネル (SMS、Email、WhatsApp、Voice など) に制限されています。


もっと詳しく知る

CPaaS XスコープのAPIキーは、NTT CPaaSプラットフォームの認証および認可フレームワークに基づいて構築されています。

  • 認証方法: サポートされている認証方法(APIキーヘッダー、基本認証、OAuth 2.0)については、API認証を参照してください。
  • スコープとロール: スコープが API エンドポイントへのアクセスを制御する方法については、API 認証 を参照してください。


関連ページ

APIキーの管理
スコープ付き API キーを作成するためのステップバイステップの手順。

アプリケーションとエンティティ
コアコンセプトと組織階層。

送信戦略
リソースの関連付けとインテリジェントなルーティング。

Webhook サブスクリプション
エンティティごとのリアルタイム配信通知。