Drive and Photo Service:Acesso OAuth 2.0 para aplicativos móveis e de desktop

1. Visão geral

Aplicativos móveis e de desktop são aplicações nativas. Não é seguro armazenar informações confidenciais, como AppSecrets, nesses aplicativos.

Um aplicativo móvel para Android ou iOS pode acionar um aplicativo de autorização por meio de um URL scheme.

Um aplicativo de desktop para macOS, Linux ou Windows pode acionar a aplicação de autorização usando um endereço IP de loopback ou um URL scheme.

Alternativamente, sua aplicação pode usar WebView para enviar uma solicitação de autorização a um aplicativo web.

(1) Funcionamento

Fluxo de código de autorização: O processo é semelhante ao fluxo de código de autorização usado na integração de aplicativos de service web. A diferença é que a etapa de obtenção do token não exige o parâmetro secret, pois não há lado do servidor e o segredo não pode ser armazenado no cliente.

(2) Fluxograma

2. Preparação

(1) Crie um domínio

Primeiro, crie um domínio https://pds.console.alibabacloud.com no console oficial do PDS. Após a criação, o sistema fornecerá um nome de domínio de API de terceiro nível no formato https://{domainId}.api.aliyunpds.com.

(2) Ative a autenticação de usuário

O PDS oferece diversos métodos comuns de autenticação de usuário. Acesse diretamente o console do PDS para ativar a integração. Para mais detalhes, consulte Account access.

(3) Crie um aplicativo para usar como cliente OAuth no console do PDS

Crie um aplicativo nativo e especifique os escopos da aplicação. Esses escopos serão exibidos na página de consentimento. Depois de criar o aplicativo, obtenha o AppId e o AppSecret correspondentes. Eles funcionam como ClientId e ClientSecret para a autorização OAuth. Mantenha o ClientSecret em segurança.

(4) Planeje um URI de redirecionamento

Use um URL scheme personalizado aplicável a aplicativos Android ou iOS

Registre um URL scheme para identificar exclusivamente o aplicativo. O esquema segue este formato: <scheme domain>://<path>?<params>=<value>.

Utilize um endereço IP de loopback personalizado para aplicativos de desktop

Inicie um service web local para escutar em uma porta específica. Exemplo: http://127.0.0.1:3000/callback ou http://[::1]:3000.

3. Obtenha um token de acesso OAuth 2.0

(1) Chame a operação Authorize

Sintaxe da solicitação de API:

GET /v2/oauth/authorize?client_id=<appId>&redirect_uri=<redirect_uri>&scope=<scope>&login_type=<login_type>&state=[state]&prompt=[prompt] HTTP/1.1
Host: {domainId}.api.aliyunpds.com

Após o envio dessa solicitação, o service de autenticação do PDS orientará o usuário a fazer login. Depois que o usuário entrar, caso seja o primeiro acesso e o parâmetro hide_consent=true não tenha sido enviado, ele será redirecionado para a página de consentimento; caso contrário, o redirecionamento ocorre diretamente para o redirect_uri informado nos parâmetros da solicitação, por exemplo: pdshz001://callback/?code=xxxx&state=abc.

(2) Conceda permissões ao aplicativo na página de consentimento

Nesta etapa, o usuário decide se concede autorização ao aplicativo de service web. Se a autorização for negada, o fluxo é encerrado. Ao conceder a autorização, o sistema redireciona o usuário para o redirect_uri especificado na solicitação inicial, por exemplo: pdshz001://callback/?code=xxxx&state=abc.

(3) Troque o código de autorização por um token de acesso

Depois de obter o código de autorização, chame a operação Token para trocá-lo por um token de acesso.

Sintaxe da solicitação de API:

POST /v2/oauth/token HTTP/1.1
Host: {domainId}.api.aliyunpds.com
Content-Type: application/x-www-form-urlencoded

code=xxx\
&client_id=your_app_id\
&redirect_uri=pdshz001://callback\
&grant_type=authorization_code

Resposta:

Exemplo de resposta de sucesso:

HTTP/1.1 200 OK
Content-Type: application/json

{
  "access_token":"Aiasd76Y****...LSdyssd2",
  "expires_time":"2019-11-11T10:10:10.009Z",
  "expire_in": 7200,
  "token_type":"Bearer",
  "refresh_token":"LSLKdklksd...li3ew6"
}

4. Chame operações da API do PDS

Use o token de acesso para chamar operações da API do PDS. Inclua o token de acesso no cabeçalho Authorization das solicitações de API.

Para mais detalhes sobre como realizar as chamadas, consulte Calling methods.

5. Atualize o token de acesso

(1) Sintaxe da solicitação de API

POST /v2/oauth/token HTTP/1.1
Host: {domainId}.api.aliyunpds.com
Content-Type: application/x-www-form-urlencoded

refresh_token=xxx\
&client_id=xxx\
&grant_type=refresh_token

Parâmetros da solicitação

(2) Resposta

HTTP/1.1 200 OK
Content-Type: application/json

{
  "access_token":"xxxxxxxxx",
  "expires_in":3920,
  "expire_time":"2019-11-11T10:10:10.009Z",
  "token_type":"Bearer"
}

Parâmetros da resposta

Mesma estrutura de resposta descrita em (3) Exchange the authorization code for an access token.