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-timestamp | Required | 1970年1月1日 00:00:00協定世界時(UTC)からの経過時間(ミリ秒) |
x-ncp-iam-access-key | Required | NAVERクラウドプラットフォームから発行された Access Key |
x-ncp-apigw-signature-v2 | Required | NAVERクラウドプラットフォームから発行された Access Keyとマッピングする Secret Keyと HMAC暗号化アルゴリズム(HmacSHA256)でリクエスト情報を暗号化した後、Base64でエンコードした署名 |
Content-type | Required | リクエストデータの形式application/json |
レスポンス
共通レスポンス形式を説明します。
レスポンスステータスコード
レスポンスステータスコードの説明は次の通りです。
HTTPステータスコード | コード | メッセージ | 説明 |
---|---|---|---|
400 | 400 | durationSecは次の範囲内でのみ使用可能 valid range: 600 - 43200: [durationSec] | durationSec 範囲指定エラー |
401 | 401 | MultiFactorAuthentication failed with invalid MFA one time pass code | 無効な OTP |
404 | 404 | 無効であるか、有効期限が切れた認証情報 | 無効な認証情報 |
参考
NAVERクラウドプラットフォームで共通して使用されるレスポンスステータスコードの詳細は、Ncloud APIのレスポンスステータスコードをご参照ください。
Secure Token Service API
Secure Token Serviceで提供する APIの説明は次の通りです。
API | 説明 |
---|---|
認証情報所有者の照会 | Access Key所有者を照会 |
認証情報の照会 | サブアカウント用の仮認証情報やサブアカウント、メインアカウントの永続的な Access Keyを照会 |
仮認証情報の作成 | 仮認証情報を作成 |
仮認証情報ロールの切り替え | ロール切り替えした仮認証情報を作成 |
Secure Token Service関連リソース
Secure Token Service APIについてユーザーの理解に役立つよう、さまざまな関連リソースを提供しています。
- Secure Token Service APIの使用方法
- APIの概要: NAVERクラウドプラットフォームから発行された Access Key、Secret Keyの発行と確認、リクエストヘッダに必要な署名の作成方法
- Sub Accountご利用ガイド: NAVERクラウドプラットフォームコンソールから発行されたサブアカウントの Access Key発行と確認方法
- Ncloudの共通レスポンスステータスコード: Secure Token Serviceで使用される NAVERクラウドプラットフォームの共通レスポンスステータスコード情報
- Sub Accountサービスの使用方法
- Sub Accountご利用ガイド: NAVERクラウドプラットフォームコンソールで Sub Accountサービスを使用する方法
- Ncloud使用環境ガイド: VPC、Classic環境とサポート有無に関するガイド
- 料金プランの紹介、特長、詳細機能: Sub Accountサービスの料金体系、特長、詳細機能のサマリー
- サービス関連の最新のお知らせ: Sub Accountサービス関連の最新共有ニュース
- よくある質問: Secure Token Serviceユーザーからのよくある質問
- お問い合わせ: APIガイドだけでは不明な点が解消されない場合、直接問い合わせ
この記事は役に立ちましたか?