역할 전환
- 인쇄
- PDF
역할 전환
- 인쇄
- PDF
기사 요약
이 요약이 도움이 되었나요?
의견을 보내 주셔서 감사합니다.
대상 역할의 권한을 가진 Secure Token Service를 생성합니다.
API
POST /switch-role
Content-Type: application/json; charset=utf-8
x-ncp-apigw-timestamp: {Timestamp}
x-ncp-iam-access-key: {Sub Account Access Key}
x-ncp-apigw-signature-v2: {API Gateway Signature}
API Header
| 항목 | 설명 |
|---|---|
| Content-Type | 요청 Body Content Type을 application/json으로 지정 (POST) |
| x-ncp-apigw-timestamp | 1970 년 1 월 1 일 00:00:00 협정 세계시(UTC)부터의 경과 시간을 밀리초(Millisecond)로 나타낸 것 API Gateway 서버와 시간차가 5 분 이상 나는 경우 유효하지 않은 요청으로 간주 x-ncp-apigw-timestamp:{Timestamp} |
| x-ncp-iam-access-key | IAM 콘솔에서 발급한 SubAccount Access Key 또는 생성한 STS accessKeyx-ncp-iam-access-key:{Sub Account Access Key or STS Access Key} |
| x-ncp-apigw-signature-v2 | Access Key ID 값 과 Secret Key 로 암호화한 서명x-ncp-apigw-signature-v2:{API Gateway Signature} |
NAVER Cloud Platform 인증키 및 Signature 생성 가이드 바로가기
요청
{
"roleNrn": "string",
"durationSec": "integer"
}
| 파라미터 | 필수여부 | 타입 | 제약사항 | 설명 |
|---|---|---|---|---|
| roleNrn | Y | string | 전환하려는 역할의 NRN | |
| durationSec | N | integer | accessKey 지속 시간(초) default: 3600, min: 600, max: 43200 |
응답
{
"switchedRole": "string",
"credentials": {
"accessKey": "string",
"keySecret": "string",
"useMfa": "string",
"createTime": "string",
"expireTime": "string"
}
}
| 항목 | 타입 | 설명 | 비고 |
|---|---|---|---|
| switchedRole | string | 전환된 역할의 NRN | |
| accessKey | string | accessKey | |
| keySecret | string | secretKey | |
| createTime | string | 생성 일자 | |
| expireTime | string | 만료 일자 | |
| useMfa | boolean | MFA 인증 여부 | 공공 환경에서는 MFA를 지원하지 않음 |
에러
아래 에러 코드는 이 액션(Action)에서 특징적으로 발생하는 에러입니다.
공통적으로 발생하는 에러에 대한 상세한 설명은 NAVER Cloud Platform API를 참고해 주세요.
| HTTP status code | 에러 코드 | 에러 메시지 |
|---|---|---|
| 400 | 400 | durationSec은 다음과 같은 범위에서만 사용 가능 valid range: 600 - 43200 : [durationSec] |
이 문서가 도움이 되었습니까?