역할 전환
- 인쇄
- PDF
역할 전환
- 인쇄
- PDF
Article Summary
Share feedback
Thanks for sharing your feedback!
대상 역할의 권한을 가진 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} |
참고
네이버 클라우드 플랫폼 인증키 및 Signature 생성 방법에 대한 설명은 Ncloud API를 참조해 주십시오.
요청
{
"roleNrn": "string",
"durationSec": "integer",
"serialNumber": "string",
"tokenCode": "integer"
}
| 파라미터 | 필수여부 | 타입 | 제약사항 | 설명 |
|---|---|---|---|---|
| roleNrn | Y | string | 전환하려는 역할의 NRN | |
| durationSec | N | integer | - accessKey 지속 시간(초) default: 3600 min: 600 max: 43200 | |
| serialNumber | N | string | OTP 디바이스 NRN 또는 시리얼 번호 | |
| tokenCode | N | integer | OTP 인증 번호 |
참고
'MFA serialNumber'는 포털 마이페이지 > 계정 관리 > 2차 인증 관리 메뉴에서 확인할 수 있습니다.
응답
{
"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 인증 여부 |
에러
아래 에러 코드는 이 액션(Action)에서 특징적으로 발생하는 에러입니다. 공통적으로 발생하는 에러에 대한 상세한 설명은 NAVER Cloud Platform API를 참고해 주세요.
| HTTP status code | 에러 코드 | 에러 메시지 |
|---|---|---|
| 400 | 400 | durationSec은 다음과 같은 범위에서만 사용 가능 valid range: 600 - 43200 : [durationSec] |
이 문서가 도움이 되었습니까?