OAuth는 2.0 표준은 RFC 6749 문서. 이 문서는 첫째 어떤 OAuth를 예를 설명합니다.
클라이언트와 리소스 소유자 : OAuth를 두 가지 역할을 구분하는 데 사용 권한의 레이어를 소개합니다. 후 ...... 자원 소유자의 동의는, 리소스 서버는 클라이언트에 토큰을 발행 할 수 있습니다.
데이터를 요청하는 클라이언트 토큰입니다.
이 구절의 의미하는 것은 핵심 문제는 타사 응용 프로그램에의 OAuth 토큰 것입니다. 그런 다음, RFC 6749는 쓰기 위하여 계속 :
인터넷) 다양한 시나리오가 기본이 표준은 인증 토큰 (권한 부여)을 얻을 수있는 네 가지 방법을 정의합니다.
즉, OAuth는 2.0 네 가지 과정을 얻을 토큰을 정의합니다. 당신은 최고의 타사 응용 프로그램에 발급 된 토큰을 맞는 하나를 선택할 수 있습니다. 여기에 네 개의 라이센스입니다.
- 인증 코드 (인증 코드)
- 숨겨진 (암시)
- 암호 (패스워드)를 입력 :
- 클라이언트 인증서 (클라이언트 자격 증명)
클라이언트 ID (클라이언트 ID) 및 클라이언트의 비밀 : 토큰이 먼저 첫번째 파일링 시스템을 오는 자신을 식별 한 다음 두 개의 식별 코드를 얻을 것이다 있어야하기 전에 관계없이 적용하는 라이센스, 타사 응용 프로그램의 어떤 종류의 참고 키 (클라이언트의 비밀). 이 토큰의 남용을 방지하는 것입니다, 토큰을받지 않습니다 타사 응용 프로그램에 대한 기록이 없었다.
첫 번째 인증 : 인증 코드
인증 코드 (인증 코드) 모드가 인증 코드를 요청하고, 취득한 토큰 코드를 사용하는 타사 프로그램을 말한다.
이 방법은 가장 일반적으로 안전은 백 엔드 웹 응용 프로그램이있는 사람들을 위해 적당하다, 가장 높은 프로세스를 사용한다. 전면 투과 한 인증 코드는 토큰 후단에 저장되고, 서버 자원의 모든 통신은 후단에서 완료된다. 이러한 별도의 전방 및 후방 단부는, 토큰의 누설을 방지 할 수있다.
첫 번째 단계는, 웹 사이트가 링크를 제공, 그것은 사용자가 클릭 한 후 B 사이트로 이동합니다, A 사이트에 대한 사용자 권한 부여 데이터를 사용합니다. 여기를 개략적으로 점프 사이트에 대한 사이트 B 링크입니다.
HTTPS : // b.com/oauth/authorize? RESPONSE_TYPE = 코드 및 CLIENT_ID = & CLIENT_ID 를 redirect_uri = CALLBACK_URL 및 범위 = 읽기
위의 URL에서 response_type
매개 변수가 요청 된 인증 코드 (반환 할 것을 나타냅니다 code
), client_id
매개 변수 B는 요청 수 있도록 누구인지, redirect_uri
파라미터 B 요청을 수락하거나 거절 할 수있는 점프의 URL, scope
매개 변수는 요청 된 인증 범위 (여기서, 읽기 전용)을 나타냅니다.
사용자가 이동 한 후 두 번째 단계, B 사이트는 사이트 라이센스를 제공하기로 합의하는 경우 사용자가 로그인 한 후 요청을해야합니다. 다음 사이트가 B의로 다시 이동합니다 동의 사용자 redirect_uri
매개 변수는 URL을 지정합니다. 점프, 다음과 같이 인증 코드를 반환합니다.
HTTPS : // a.com/callback?code=AUTHORIZATION_CODE
위의 URL은 code
매개 변수는 인증 코드입니다.
세 번째 단계, A는 인증 코드 후 웹 사이트를 얻기 위해, 후단에서 B-사이트에 요청 토큰이 될 수 있습니다.
HTTPS : // b.com/oauth/token? CLIENT_ID = CLIENT_ID 및 client_secret = CLIENT_SECRET 및 grant_type = authorization_code 및 코드 = & AUTHORIZATION_CODE 를 redirect_uri = CALLBACK_URL
상기 URL에서, client_id
매개 변수, client_secret
파라미터 (그래서 A와 B의 ID를 확인하는 client_secret
파라미터, 그렇게 만 후방 종료 요청 기밀) grant_type
파라미터의 값이되고 AUTHORIZATION_CODE
, 라이센스가 인증 코드를 이용하여 표현되고, code
상기 파라미터는 걸음을하는 인증 코드로, redirect_uri
매개 변수 발행 콜백 URL 토큰입니다.
상기 B 사이트는 요청을 수신 한 후, 네 번째 단계는 그 토큰을 발급한다. 구체적인 방법은하는 것입니다 redirect_uri
, URL을 지정 일부 JSON 데이터를 전송합니다.
{ "access_token":"ACCESS_TOKEN", "token_type":"bearer", "expires_in":2592000, "refresh_token":"REFRESH_TOKEN", "scope":"read", "uid":100101, "info":{...} }
上面 JSON 数据中,access_token
字段就是令牌,A 网站在后端拿到了。
第二种方式:隐藏式
有些 Web 应用是纯前端应用,没有后端。这时就不能用上面的方式了,必须将令牌储存在前端。RFC 6749 就规定了第二种方式,允许直接向前端颁发令牌。这种方式没有授权码这个中间步骤,所以称为(授权码)"隐藏式"(implicit)。
第一步,A 网站提供一个链接,要求用户跳转到 B 网站,授权用户数据给 A 网站使用。
https://b.com/oauth/authorize? response_type=token& client_id=CLIENT_ID& redirect_uri=CALLBACK_URL& scope=read
上面 URL 中,response_type
参数为token
,表示要求直接返回令牌。
第二步,用户跳转到 B 网站,登录后同意给予 A 网站授权。这时,B 网站就会跳回redirect_uri
参数指定的跳转网址,并且把令牌作为 URL 参数,传给 A 网站。
https://a.com/callback#token=ACCESS_TOKEN
上面 URL 中,token
参数就是令牌,A 网站因此直接在前端拿到令牌。
注意,令牌的位置是 URL 锚点(fragment),而不是查询字符串(querystring),这是因为 OAuth 2.0 允许跳转网址是 HTTP 协议,因此存在"中间人攻击"的风险,而浏览器跳转时,锚点不会发到服务器,就减少了泄漏令牌的风险。
这种方式把令牌直接传给前端,是很不安全的。因此,只能用于一些安全要求不高的场景,并且令牌的有效期必须非常短,通常就是会话期间(session)有效,浏览器关掉,令牌就失效了。
第三种方式:密码式
如果你高度信任某个应用,RFC 6749 也允许用户把用户名和密码,直接告诉该应用。该应用就使用你的密码,申请令牌,这种方式称为"密码式"(password)。
第一步,A 网站要求用户提供 B 网站的用户名和密码。拿到以后,A 就直接向 B 请求令牌。
https://oauth.b.com/token? grant_type=password& username=USERNAME& password=PASSWORD& client_id=CLIENT_ID
上面 URL 中,grant_type
参数是授权方式,这里的password
表示"密码式",username
和password
是 B 的用户名和密码。
第二步,B 网站验证身份通过后,直接给出令牌。注意,这时不需要跳转,而是把令牌放在 JSON 数据里面,作为 HTTP 回应,A 因此拿到令牌。
这种方式需要用户给出自己的用户名/密码,显然风险很大,因此只适用于其他授权方式都无法采用的情况,而且必须是用户高度信任的应用。
第四种方式:凭证式
最后一种方式是凭证式(client credentials),适用于没有前端的命令行应用,即在命令行下请求令牌。
第一步,A 应用在命令行向 B 发出请求。
https://oauth.b.com/token? grant_type=client_credentials& client_id=CLIENT_ID& client_secret=CLIENT_SECRET
上面 URL 中,grant_type
参数等于client_credentials
表示采用凭证式,client_id
和client_secret
用来让 B 确认 A 的身份。
第二步,B 网站验证通过以后,直接返回令牌。
这种方式给出的令牌,是针对第三方应用的,而不是针对用户的,即有可能多个用户共享同一个令牌。
令牌的使用
A 网站拿到令牌以后,就可以向 B 网站的 API 请求数据了。
此时,每个发到 API 的请求,都必须带有令牌。具体做法是在请求的头信息,加上一个Authorization
字段,令牌就放在这个字段里面。
curl -H "Authorization: Bearer ACCESS_TOKEN" \ "https://api.b.com"
上面命令中,ACCESS_TOKEN
就是拿到的令牌。
更新令牌
令牌的有效期到了,如果让用户重新走一遍上面的流程,再申请一个新的令牌,很可能体验不好,而且也没有必要。OAuth 2.0 允许用户自动更新令牌。
具体方法是,B 网站颁发令牌的时候,一次性颁发两个令牌,一个用于获取数据,另一个用于获取新的令牌(refresh token 字段)。令牌到期前,用户使用 refresh token 发一个请求,去更新令牌。
https://b.com/oauth/token? grant_type=refresh_token& client_id=CLIENT_ID& client_secret=CLIENT_SECRET& refresh_token=REFRESH_TOKEN
上面 URL 中,grant_type
参数为refresh_token
表示要求更新令牌,client_id
参数和client_secret
参数用于确认身份,refresh_token
参数就是用于更新令牌的令牌。
B 网站验证通过以后,就会颁发新的令牌。