기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

리디렉션 및 권한 부여 엔드포인트

/oauth2/authorize 엔드포인트는 두 개의 리디렉션 대상을 지원하는 리디렉션 엔드포인트입니다. identity_provider 또는 idp_identifier 파라미터를 에 포함하면 자동으로 사용자를 해당 자격 증명 공급자(IdP )의 로그인 페이지로 URL리디렉션합니다. 그렇지 않으면 요청에 포함시킨 것과 동일한 URL 파라미터를 Login 엔드포인트 사용하여 로 리디렉션됩니다.

권한 부여 엔드포인트는 호스팅 UI 또는 IdP 로그인 페이지로 리디렉션합니다. 이 엔드포인트에서 사용자 세션의 대상은 사용자가 브라우저에서 직접 상호 작용해야 하는 웹 페이지입니다.

권한 부여 엔드포인트를 사용하려면 사용자 풀에 다음 사용자 풀 세부 정보에 대한 정보를 제공하는 매개변수를 사용하여 /oauth2/authorize에서 사용자 브라우저를 호출하세요.

Amazon Cognito가 수신 클레임을 검증하는 데 사용하는 state 및 nonce 파라미터를 제공할 수도 있습니다.

GET /oauth2/authorize

/oauth2/authorize 엔드포인트는 HTTPS GET만 지원합니다. 대체로 앱은 사용자의 브라우저에서 이 요청을 시작합니다. 를 통해서만 /oauth2/authorize 엔드포인트에 요청할 수 있습니다HTTPS.

권한 부여 엔드포인트 의 OpenID Connect(OIDC) 표준에서 권한 부여 엔드포인트의 정의에 대해 자세히 알아볼 수 있습니다.

요청 파라미터

긍정적 응답이 있는 요청의 예

다음 예제에서는 /oauth2/authorize 엔드포인트에 대한 HTTP 요청 형식을 보여줍니다.

인증 코드 권한 부여

권한 부여 코드 부여에 대한 요청의 예입니다.

예 - GET 요청

다음 요청은 사용자가 redirect_uri 대상의 앱에 전달하는 권한 부여 코드를 검색하는 세션을 시작합니다. 이 세션은 사용자 속성 및 Amazon Cognito 셀프 서비스 API 작업에 대한 액세스 범위를 요청합니다.

GET https://mydomain.auth.us-east-1.amazoncognito.com/oauth2/authorize?
response_type=code&
client_id=1example23456789&
redirect_uri=https://www.example.com&
state=abcdefg&
scope=openid+profile+aws.cognito.signin.user.admin

예 - 응답

Amazon Cognito 인증 서버는 권한 부여 코드 및 상태를 통해 앱으로 다시 리디렉션합니다. 권한 부여 코드는 5분 동안 유효합니다.

HTTP/1.1 302 Found
Location: https://www.example.com?code=a1b2c3d4-5678-90ab-cdef-EXAMPLE11111&state=abcdefg

를 사용한 인증 코드 부여 PKCE

이는 를 사용한 권한 부여 코드 부여에 대한 예제 요청입니다PKCE.

예 - GET 요청

다음 요청은 이전 요청에 code_challenge 파라미터를 추가합니다. 토큰에 대한 코드 교환을 완료하려면 /oauth2/token 엔드포인트에 대한 요청에 code_verifier 파라미터를 포함해야 합니다.

GET https://mydomain.auth.us-east-1.amazoncognito.com/oauth2/authorize?
response_type=code&
client_id=1example23456789&
redirect_uri=https://www.example.com&
state=abcdefg&
scope=aws.cognito.signin.user.admin&
code_challenge_method=S256&
code_challenge=a1b2c3d4...

예 - 응답

인증 서버는 권한 부여 코드와 상태로 애플리케이션으로 다시 리디렉션됩니다. 코드와 상태는 조각이 아닌 쿼리 문자열 파라미터에서 반환되어야 합니다.

HTTP/1.1 302 Found
Location: https://www.example.com?code=a1b2c3d4-5678-90ab-cdef-EXAMPLE11111&state=abcdefg

openid 범위가 없는 토큰 부여

암시적 권한을 생성하고 사용자 세션으로 JWTs 직접 반환하는 요청의 예입니다.

예 - GET 요청

다음 요청은 권한 부여 서버의 암시적 권한 부여에 대한 것입니다. Amazon Cognito의 액세스 토큰은 셀프 서비스 API 작업을 승인합니다.

GET https://mydomain.auth.us-east-1.amazoncognito.com/oauth2/authorize?
response_type=token&
client_id=1example23456789&
redirect_uri=https://www.example.com&
state=abcdefg&
scope=aws.cognito.signin.user.admin

예 - 응답

Amazon Cognito 권한 부여 서버는 액세스 토큰을 통해 앱으로 다시 리디렉션합니다. openid 범위가 요청되지 않았기 때문에 Amazon Cognito에서 ID 토큰을 반환하지 않습니다. 또한 Amazon Cognito는 이 흐름에서 새로 고침 토큰을 반환하지 않습니다. Amazon Cognito는 쿼리 문자열이 아닌 조각에서 액세스 토큰과 상태를 반환합니다.

HTTP/1.1 302 Found
Location: https://YOUR_APP/redirect_uri#access_token=ACCESS_TOKEN&token_type=bearer&expires_in=3600&state=STATE

openid 범위가 있는 토큰 부여

암시적 권한을 생성하고 사용자 세션으로 JWTs 직접 반환하는 요청의 예입니다.

예 - GET 요청

다음 요청은 권한 부여 서버의 암시적 권한 부여에 대한 것입니다. Amazon Cognito의 액세스 토큰은 사용자 속성 및 셀프 서비스 API 작업에 대한 액세스를 승인합니다.

GET
https://mydomain.auth.us-east-1.amazoncognito.com/oauth2/authorize? 
response_type=token& 
client_id=1example23456789& 
redirect_uri=https://www.example.com& 
state=abcdefg&
scope=aws.cognito.signin.user.admin+openid+profile
                    

예 - 응답

권한 부여 서버는 액세스 토큰 및 ID 토큰을 사용하여 앱으로 다시 리디렉션됩니다(openid범위가 포함되었으므로).

HTTP/1.1 302 Found
Location: https://www.example.com#id_token=eyJra67890EXAMPLE&access_token=eyJra12345EXAMPLE&token_type=bearer&expires_in=3600&state=abcdefg

부정 응답 예제

Amazon Cognito가 요청을 거부할 수 있습니다. 부정적인 요청에는 HTTP 오류 코드와 요청 파라미터를 수정하는 데 사용할 수 있는 설명이 함께 제공됩니다. 다음은 부정적인 응답의 예입니다.