Secure Token Serviceの概要
    • PDF

    Secure Token Serviceの概要

    • PDF

    記事の要約

    Classic/VPC環境で利用できます。

    Secure Token Service(STS)は、NAVERクラウドプラットフォームのリソースアクセスを制御するサブアカウント用の仮認証情報(Access Key、Secret Key)を発行するサービスです。Secure Token Serviceでは、サブアカウント用仮認証情報関連の APIを RETSTful形式で提供します。
    Secure Token Serviceを使用して作成した仮認証情報の特徴は次の通りです。

    • サブアカウントでのみ作成できます。
    • 一部の違いを除き、永続的な Access Keyと同じ効力を持ちます。
    • 有効期限が存在します。期限切れとなった Access Keyは認識されないか、アクセスが許可されません。したがって、必要でなくなった時に交換するか、明示的に交換する必要はありません。
    • 期間制限のない Access Keyをアプリケーションにデプロイしたり、含める必要はありません。
    • 仮認証情報を作成する際、MFA認証を含めることができます。NAVERクラウドプラットフォームでは MFA手段として OTP認証を提供します。

    Secure Token Serviceの共通設定

    Secure Token Service APIで共通して使用されるリクエスト形式とレスポンス形式を説明します。

    リクエスト

    共通リクエスト形式を説明します。

    API URL

    リクエスト API URLは次の通りです。

    https://sts.apigw.ntruss.com
    

    リクエストヘッダ

    リクエストヘッダの説明は次の通りです。

    フィールド必須の有無説明
    x-ncp-apigw-timestampRequired1970年1月1日 00:00:00協定世界時(UTC)からの経過時間(ミリ秒)
  • API Gatewayサーバとの時間差が5分以上の場合は無効なリクエストとみなす
  • x-ncp-iam-access-keyRequiredNAVERクラウドプラットフォームから発行された Access Key
  • Access Keyの発行と確認: 認証キーの作成を参照
  • サブアカウントの Access Key発行と確認: サブアカウントの作成を参照
  • x-ncp-apigw-signature-v2RequiredNAVERクラウドプラットフォームから発行された Access Keyとマッピングする Secret Keyと HMAC暗号化アルゴリズム(HmacSHA256)でリクエスト情報を暗号化した後、Base64でエンコードした署名
  • Secret Keyの発行と確認: 認証キーの作成を参照
  • 署名の作成: シグネチャーの作成を参照
  • Content-typeRequiredリクエストデータの形式
  • application/json
  • レスポンス

    共通レスポンス形式を説明します。

    レスポンスステータスコード

    レスポンスステータスコードの説明は次の通りです。

    HTTPステータスコードコードメッセージ説明
    400400durationSecは次の範囲内でのみ使用可能
    valid range: 600 - 43200: [durationSec]
    durationSec範囲指定エラー
    401401MultiFactorAuthentication failed with invalid MFA one time pass code無効な OTP
    404404無効であるか、有効期限が切れた認証情報無効な認証情報
    参考

    NAVERクラウドプラットフォームで共通して使用されるレスポンスステータスコードの詳細は、Ncloud APIのレスポンスステータスコードをご参照ください。

    Secure Token Service API

    Secure Token Serviceで提供する APIの説明は次の通りです。

    API説明
    認証情報所有者の照会Access Key所有者を照会
    認証情報の照会サブアカウント用の仮認証情報やサブアカウント、メインアカウントの永続的な Access Keyを照会
    仮認証情報の作成仮認証情報を作成
    仮認証情報ロールの切り替えロール切り替えした仮認証情報を作成

    Secure Token Service関連リソース

    Secure Token Service APIについてユーザーの理解に役立つよう、さまざまな関連リソースを提供しています。


    この記事は役に立ちましたか?

    Changing your password will log you out immediately. Use the new password to log back in.
    First name must have atleast 2 characters. Numbers and special characters are not allowed.
    Last name must have atleast 1 characters. Numbers and special characters are not allowed.
    Enter a valid email
    Enter a valid password
    Your profile has been successfully updated.