Preços
Novidades
Criar conta
Iniciar sessão
PreçosSobre nósContacta-nosTestemunhos
Iniciar sessãoCriar contaEsqueceste-te da palavra-passe?
Termos de serviçoPolítica de privacidadeTermos para programadoresSegurançaDefinições de privacidadeRGPD
NovidadesFuncionalidadesCentro de ajudaEstado do sistema
Aplicação para iOSAplicação para AndroidAplicação web

Aplicações OAuth

Uma aplicação OAuth dá à tua integração o ID do cliente e, no caso de uma aplicação confidencial, o segredo do cliente de que precisa para se autenticar na nossa API. Consulta Autenticação para saberes como os usar.

Para gerir aplicações OAuth, precisas da permissão Administrar na conta. Mais informações sobre Permissões.

Passos para criar uma aplicação OAuth

  1. Vai a Definições (menu principal) > Conta > Aplicações OAuth
  2. Seleciona Criar aplicação OAuth
  3. Introduz um Nome
  4. Seleciona um Tipo de cliente
  5. Introduz os teus URIs de redirecionamento, um por linha
  6. Seleciona Criar
  7. Copia o ID do cliente e o Segredo do cliente, se for mostrado, e depois seleciona Concluído

Tipo de cliente

Seleciona «Confidencial» para aplicações do lado do servidor que conseguem guardar um segredo do cliente em segurança. Seleciona «Público» para aplicações de browser, móveis ou nativas que não o conseguem — uma aplicação pública não recebe segredo do cliente e, em vez disso, o fluxo é protegido pelo PKCE. O tipo de cliente não pode ser alterado depois de a aplicação ser criada.

URIs de redirecionamento

Um URI de redirecionamento tem de usar https, ou http com um endereço de loopback (localhost, 127.0.0.1 ou ::1) para desenvolvimento local. Uma aplicação pública também pode usar um esquema de URI de uso privado em notação de domínio invertido, como com.example.app:/oauth/callback.

Passos para alterar um nome ou um URI de redirecionamento

  1. Vai a Definições (menu principal) > Conta > Aplicações OAuth > a tua aplicação
  2. Altera o Nome ou os URIs de redirecionamento
  3. Seleciona Guardar

Passos para rodar um segredo do cliente

Roda o segredo do cliente se o atual tiver sido perdido ou exposto. Só as aplicações confidenciais têm um.

  1. Vai a Definições (menu principal) > Conta > Aplicações OAuth > a tua aplicação
  2. Seleciona Rodar segredo do cliente > Rodar segredo
  3. Copia o novo Segredo do cliente

O segredo do cliente anterior deixa de funcionar imediatamente, por isso atualiza a tua aplicação assim que o rodares. As autorizações que os utilizadores já deram à tua aplicação mantêm-se.

Passos para eliminar uma aplicação OAuth

  1. Vai a Definições (menu principal) > Conta > Aplicações OAuth > a tua aplicação
  2. Seleciona Eliminar e confirma

Eliminar uma aplicação OAuth revoga as autorizações que os utilizadores lhe deram. Os tokens de acesso já emitidos podem continuar a funcionar até expirarem.

Introdução
Autenticação