Autenticação
Autenticação
A API Frame.io V4 usa o Adobe Identity Management Service (IMS), a plataforma de identidade OAuth 2.0 da Adobe. Há duas categorias de autenticação:
Permite que usuários técnicos ou de conta de serviço executem ações sem interação do usuário. Disponível apenas para contas Frame.io V4 administradas pelo Adobe Admin Console.
Atua como o usuário ao qual o token pertence. Disponível para todas as contas Frame.io V4 administradas pelo Adobe Admin Console, bem como para contas gerenciadas pelo Frame que mudaram para a Autenticação da Adobe.
Guias de autenticação do SDK
Os SDKs do Frame.io gerenciam todo o ciclo de vida do OAuth para você: URLs de autorização, troca de tokens, atualização automática e revogação.Escolha sua linguagem para começar:
ServerToServerAuth, WebAppAuth e SPAAuth com suporte síncrono e assíncrono.
Autenticação ServerToServerAuth, WebAppAuth, SPAAuth e NativeApp para Node.js e ambientes de navegador.
Se você estiver criando um serviço de backend ou automação, comece com Server-to-Server. Se o aplicativo tiver usuários que fazem logon, escolha Web App, se puder armazenar um Client Secret, ou SPA (se você não pode).
Autenticação do usuário
As credenciais de autenticação do usuário são criadas no Adobe Developer Console. A Adobe oferece suporte a três tipos de credenciais. Escolha aquele que corresponde à arquitetura do seu aplicativo:
Para aplicativos do lado do servidor que podem armazenar um client secret com segurança (Flask, Django, FastAPI, Express etc.).
Para aplicativos baseados em navegador, CLIs ou aplicativos de desktop que não podem armazenar um client secret. Usa PKCE.
Para aplicativos móveis nativos ou de desktop que usam redirecionamentos de esquema de URI personalizado.
O Frame.io Python SDK não inclui uma classe de credencial de Native App, pois o Python não tem uma forma padrão de registrar manipuladores de esquema de URI personalizado. Use Aplicativo Web com um servidor de callback local. O SDK para TypeScript oferece suporte a todos os três tipos de credenciais.
Autenticação servidor para servidor
A autenticação servidor para servidor permite que seu aplicativo atue como um usuário de conta de serviço, sem intervenção humana. Seu aplicativo se autentica com credenciais de cliente e recebe um token de acesso diretamente. As ações da conta de serviço ficam visíveis no Frame.io com o nome da conta de serviço. O acesso à conta de serviço é gerenciado pelo Adobe Admin Console e Developer Console. No momento, o nome da conta de serviço não pode ser ajustado. Consulte os guias específicos de SDK acima para obter detalhes de implementação.
Consulte Automatize sua configuração usando o suporte servidor para servidor do Frame.io para saber mais sobre a configuração da conta de serviço.
Como funciona a autenticação do Adobe IMS
O Adobe Identity Management Service (IMS) é o recurso de gerenciamento de identidade da Adobe baseado em OAuth 2.0 que oferece suporte à autenticação. Há duas etapas necessárias para gerar o token de acesso:
Autorização do usuário
Primeiro, o usuário autoriza o aplicativo antes da geração de um token. Os detalhes estão aqui.
Troca de token
Em seguida, busque o token de acesso. A etapa acima retorna um código no corpo da resposta necessário nesta etapa. Consulte os pontos de acesso exatos e os parâmetros a serem usados aqui.
As etapas acima são necessárias para todos os três tipos de credenciais de aplicativo. Há diferenças na forma como os pontos de acesso do IMS /authorize/v2 e /token/v3 são acessados para obter o token. Depois de ter o token de acesso, você pode usá-lo para interagir com a API Frame.io V4.
Para autenticação Servidor para servidor, não há etapa de autorização do usuário. O aplicativo usa credenciais de cliente diretamente para obter um token de acesso por meio da concessão client_credentials.
Uso do token de acesso
Quando tiver um token de acesso, inclua-o no cabeçalho Authorization de todas as solicitações de API:
Os SDKs do Frame.io fazem isso para você. Basta passar o token, ou um chamável que forneça o token, ao criar o cliente.
TTL do token
Os tokens de acesso são de curta duração. Normalmente, expiram em 1 hora. Para fluxos de autenticação do usuário (Aplicativo Web, SPA, Native App), o Adobe IMS também retorna um token de atualização que pode ser usado para obter um novo token de acesso sem exigir que o usuário faça logon novamente. Os tokens de atualização têm duração maior, mas também expiram eventualmente.
Para autenticação servidor para servidor, não há tokens de atualização. As próprias credenciais de cliente nunca expiram, a menos que sejam alternadas manualmente, portanto o aplicativo sempre pode solicitar um novo token de acesso.
Os SDKs do Frame.io processam a atualização de token automaticamente. Consulte os guias específicos de SDK para obter detalhes.
Escopos
Ao criar credenciais no Adobe Developer Console, você configurará escopos OAuth que determinam o que seu aplicativo pode acessar. Os SDKs do Frame.io usam os seguintes escopos padrão:
O escopo offline_access é necessário para fluxos de autenticação do usuário receberem um token de atualização. Sem ele, você receberá apenas um token de acesso e os usuários precisarão se autenticar novamente quando ele expirar.
Tokens de desenvolvedor legados
Para contas migradas da V4 que ainda não são administradas através do Adobe Admin Console, você pode continuar a usar tokens de desenvolvedor legados gerenciados no site de desenvolvedor do Frame.io. Passe o token diretamente para o SDK:
Ao usar um token de desenvolvedor legado com a API V4, você deve adicionar o cabeçalho x-frameio-legacy-token-auth com um valor de true a todas as solicitações de API. Se estiver usando o SDK, defina-o pelas opções de solicitação do cliente.
Tokens de desenvolvedor legados não expiram, mas são um mecanismo de transição. Para novas integrações e cargas de trabalho de produção, recomendamos usar um dos fluxos OAuth 2.0 abaixo. Consulte o Guia de migração para obter detalhes.
Se você for um cliente Enterprise migrando do Frame.io Legacy para a V4, entre em contato com seu CSM para obter ajuda na configuração com o token de desenvolvedor legado e a V4
Consulte o Guia de migração para obter detalhes sobre a transição de tokens legados para a autenticação do Adobe IMS.