すべてのプロダクト
Search
ドキュメントセンター

Resource Access Management:OAuth アプリケーションの概要

最終更新日:May 28, 2026

Resource Access Management (RAM) は、OAuth 2.0 および OAuth 2.1 プロトコルによるユーザー認証とアプリケーションの認可に対応しています。

基本概念

概念

説明

ユーザー

ログインしてアプリケーションにクラウドリソースへのアクセスを認可する、Alibaba Cloud アカウント、RAM ユーザー、または RAM ロールです。

説明

2024 年 9 月 10 日以前に作成された OAuth アプリケーションは、RAM ロールに対応していません。古いアプリケーションでこの機能を有効にするには、チケットを送信してください。

Alibaba Cloud OAuth サービス

ユーザーを認証してその認可を取得し、認可されたアプリケーションにユーザーアイデンティティを表すトークンを発行するサービスです。

クライアントアプリケーション

現在の Alibaba Cloud アカウントで作成されたアプリケーションです。このアカウント内のユーザーは、認可なしで直接アクセスできます。他の Alibaba Cloud アカウントのユーザーは、利用前にインストールと認可を行う必要があります。

以下のタイプのクライアントアプリケーションを作成できます。

  • [ Web アプリケーション ]:ブラウザーで実行されるアプリケーションです。

  • [ ネイティブアプリケーション ]:デスクトップまたはモバイルオペレーティングシステムで実行されるローカルアプリケーションです。

  • [ サーバーアプリケーション ]:ユーザーログインなしで Alibaba Cloud サービスに直接アクセスするアプリケーションです。現在、SCIM ベースのユーザープロビジョニングアプリケーションにのみ対応しています。

サードパーティアプリケーション

自身のアカウント外で作成された、インストールと認可が必要なアプリケーションです。

公式アプリケーション

Alibaba Cloud サービスによって提供され、すべての Alibaba Cloud アカウントでインストール可能なサードパーティアプリケーションです。

OAuth スコープ

OAuth スコープは、ログインユーザーに代わってアプリケーションがリソースにアクセスできる範囲を制限するものです。対応しているスコープは次のとおりです。

  • openid :ユーザーの OpenID を取得します。デフォルトのスコープであり、削除できません。

    説明

    OpenID は、Alibaba Cloud UID やユーザー名を含まない一意のユーザー識別子です。これらの情報を取得するには、aliuid または profile スコープをリクエストする必要があります。

  • aliuid :RAM ユーザー UID と親アカウント UID を含む Alibaba Cloud UID を取得します。

  • profile :ユーザーのログイン名を取得します。Alibaba Cloud アカウントの場合はログイン名を返します。RAM ユーザーの場合は UPN と表示名を返します。

  • /acs/ccc :Alibaba Cloud Call Center API にアクセスします。

  • /acs/cloudesl :Alibaba Cloud Price Tag API にアクセスします。

  • /acs/alidns :Alibaba Cloud DNS API にアクセスします。

  • /acs/scim :SCIM にアクセスします。

  • /acs/digitalstore :Digital Store にアクセスします。

  • /acs/scsp :Smart Customer Service Platform にアクセスします。

  • /acs/cloudgame :Cloud Gaming Platform にアクセスします。

  • /acs/aiccs :Artificial Intelligence Cloud Call Service にアクセスします。

  • /acs/alimt :Machine Translation にアクセスします。

  • /acs/easygene :Genomics Computing Platform API にアクセスします。

  • /acs/mcp-server :公式 MCP サービスがクラウドサービス API を呼び出すことを認可します。

    説明

    /acs/mcp-server スコープは、OAuth 2.1 でのみ対応しています。

トークン

OAuth サービスによって発行される、ログインユーザーを表すものです。

  • ID トークン:ユーザーアイデンティティ情報を含みますが、Alibaba Cloud リソースへのアクセス権を付与するものではありません。

  • アクセストークン:ユーザーアイデンティティとアプリケーションの OAuth スコープ情報を含みます。付与されたスコープ内で Alibaba Cloud リソースにアクセスするために使用できます。

  • リフレッシュトークン:アプリケーションが新しいアクセストークンを取得するために使用されます。

Alibaba Cloud API

アプリケーションは Alibaba Cloud API を呼び出して、対応するクラウドリソースにアクセスします。

ユースケース

ID トークンクレーム

openidaliuid、および profile スコープを持つ ID トークンには、以下のクレームが含まれます。

パラメーター

説明

必要なスコープ

exp

トークンの有効期限を示す UNIX タイムスタンプです。

1517539523

openid

sub

一意で不透明なユーザー識別子です。Alibaba Cloud UID またはユーザー名は含まれません。

説明

ログインユーザーが RAM ロールの場合、sub はロールアクターに基づいて <RoleId:RoleSessionName> の形式で生成されます。各アクターは、それぞれ固有の sub を持ちます。

123456789012****

openid

aud

トークンのオーディエンスであり、OAuth アプリケーションのIDです。

4567890123456****

openid

iss

トークンの発行者です。値は https://oauth.aliyun.com です。

https://oauth.aliyun.com

openid

iat

トークンが発行された時刻を示す UNIX タイムスタンプです。

1517533200

openid

aid

ユーザーが所属する Alibaba Cloud アカウントの ID です。

177242285274****

aliuid

uid

ログインユーザーの ID です。有効な値は次のとおりです。

  • Alibaba Cloud アカウント:値は aid クレームと同じです。

  • RAM ユーザー:RAM ユーザーの ID です。

  • RAM ロール:RAM ロールの ID です。

20124982101502****

aliuid

type

ログインユーザーのタイプです。有効な値は次のとおりです。

  • account :Alibaba Cloud アカウント

  • user :RAM ユーザー

  • role :RAM ロール

user

profile

login_name

Alibaba Cloud アカウントのログイン名です。

説明

Alibaba Cloud アカウントの場合のみ返されます。

田中

profile

upn

RAM ユーザーのログイン名です。

説明

RAM ユーザーの場合のみ返されます。

Taro@examplecompany.onaliyun.com

profile

name

ログインユーザーの名前です。有効な値は次のとおりです。

  • RAM ユーザー:RAM ユーザーの表示名です。

  • RAM ロール:<RoleName:RoleSessionName> です。

説明

RAM ユーザーと RAM ロールの場合のみ返されます。

山田

profile