As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
Configure o login corporativo com o Okta para Amazon Quick no desktop
| Aplica-se a: Enterprise Edition |
| Público-alvo: administradores de sistemas |
Esta página mostra todas as quatro etapas para configurar o login corporativo com o Okta:
-
Crie um aplicativo OIDC no Okta e registre seus valores.
-
Adicione o acesso à extensão no console de administração do Amazon Quick.
-
Crie a extensão no console do Amazon Quick.
-
Baixe, verifique e distribua o aplicativo para desktop.
nota
Antes de começar, revise os pré-requisitos em. Configurando o Amazon Quick no desktop para implantações corporativas
Etapa 1: criar um aplicativo OIDC no Okta
Registre um aplicativo nativo do OIDC no Okta. O aplicativo de desktop Amazon Quick usa esse cliente para autenticar usuários por meio do fluxo de código de autorização com o PKCE e solicita os offline_access escopos openidprofile,email, e no login.
Para obter mais informações, consulte Criar integrações de aplicativos OpenID Connect
Para criar o aplicativo nativo Okta OIDC
-
No Okta Admin Console, navegue até Aplicativos → Aplicativos → Criar integração de aplicativos.
-
Selecione OIDC - OpenID Connect como método de login.
-
Selecione Aplicativo nativo como o tipo de aplicativo e escolha Avançar.
-
Configure as seguintes opções:
Configuração Valor Nome da integração do aplicativo Amazon Quick DesktopTipo de subsídio Código de autorização e token de atualização Sign-in redirecionar URIs http://localhost:18080Atribuições Atribua aos usuários ou grupos apropriados -
Escolha Salvar.
-
Na guia Geral, anote a ID do cliente.
O Okta aplica o PKCE (S256) automaticamente para aplicativos nativos.
Para verificar as configurações de autenticação
-
Na integração do aplicativo, vá para a guia Geral.
-
Em Configurações gerais, confirme se o tipo de aplicativo é nativo, se a autenticação do cliente é Nenhuma (cliente público) e se o PKCE é obrigatório.
-
Em LOGIN, confirme se
http://localhost:18080está listado como um URI de redirecionamento. -
Escolha Salvar se você fez alguma alteração.
Registre os seguintes endpoints do OIDC. Você insere esses valores, junto com a ID do cliente que você anotou anteriormente, na Etapa 2. <OKTA_DOMAIN>Substitua pelo seu domínio Okta (por exemplo,your-org.okta.com). Para obter a referência do endpoint, consulte Código de autorização com PKCE
| Campo | Valor |
|---|---|
| ID de cliente | O ID do cliente na guia Geral |
| URL do emissor | https://<OKTA_DOMAIN> |
| Endpoint de Autorização | https://<OKTA_DOMAIN>/oauth2/v1/authorize |
| Endpoint de token | https://<OKTA_DOMAIN>/oauth2/v1/token |
| TIPO DE JWKS | https://<OKTA_DOMAIN>/oauth2/v1/keys |
Use o padrão Okta domínio, não o subdomínio admin
Use seu Okta domínio padrão (por exemplo,your-org.okta.com) nesses endpoints, não o -admin subdomínio (your-org-admin.okta.com) mostrado na barra de endereço do console de administração. O -admin subdomínio não hospeda os endpoints OAuth, portanto, usá-lo faz com que o login falhe com um erro HTTP 404.
Etapa 2: Adicione o acesso à extensão no console de administração do Amazon Quick
No console de administração do Amazon Quick, adicione um acesso à extensão usando os valores do endpoint do OIDC e a ID do cliente que você registrou na Etapa 1.
Para adicionar a extensão, acesse
-
Faça login no console de administração do Amazon Quick e escolha Gerenciar conta.
-
No painel de navegação esquerdo, em Permissões, escolha Acesso à extensão.
-
Escolha Adicionar acesso à extensão.
-
Em Selecionar serviço, selecione Amazon Quick (aplicativo de desktop para Quick) e escolha Avançar.
-
Insira os detalhes da extensão usando os valores que você registrou na Etapa 1:
Campo Valor Nome Um nome para esse acesso à extensão (por exemplo, QuickDesktop-access). Essa é apenas uma referência interna e não está configurada no seu IdP. Use somente caracteres alfanuméricos e hífens, sem espaços.Description (Opcional) Uma descrição desse acesso à extensão, somente para sua referência. URL do emissor O URL exato do emissor do OIDC da Etapa 1, incluindo qualquer sufixo de caminho necessário. Endpoint de autorização O URL do endpoint de autorização do OIDC da Etapa 1 Ponto final do token O URL do endpoint do token OIDC da Etapa 1 TIPO DE JWKS O URI do conjunto de chaves Web JSON da etapa 1 ID de cliente O identificador do cliente OIDC (ID do cliente ou ID do aplicativo (cliente)) que você registrou na Etapa 1. Obrigatório. -
Escolha Adicionar.
Importante
Verifique se todos os valores estão corretos antes de escolher Adicionar. A configuração de acesso à extensão não pode ser editada após a criação. Se algum valor estiver incorreto, você deverá excluir o acesso à extensão e criar um novo.
Etapa 3: Crie a extensão no console Amazon Quick
Depois de adicionar o acesso à extensão no console de administração do Amazon Quick, crie a extensão na página Extensões no console do Amazon Quick.
Para criar a extensão
-
No console Amazon Quick, no painel de navegação esquerdo, escolha Extensões. Se você não vê Extensões, escolha Mais para encontrá-las.
-
Escolha Adicionar extensão.
-
Selecione o aplicativo de desktop para acesso rápido à extensão que você criou na Etapa 2 e escolha Avançar.
-
Escolha Criar.
Importante
Tanto a Etapa 2 quanto a Etapa 3 são obrigatórias. Se você adicionar o acesso à extensão, mas não criar a extensão, o login corporativo não estará disponível e os usuários verão o erro: “O login corporativo para o Quick Desktop não foi configurado para esta conta”.
nota
Criar a extensão é uma ação única no nível da conta. Depois que um administrador cria a extensão, o login corporativo fica disponível para todos os usuários da conta. Usuários individuais não precisam habilitar a extensão sozinhos — eles só precisam baixar o aplicativo para desktop e fazer login.
Etapa 4: Baixe, verifique e distribua o aplicativo de desktop
Nesta etapa, você baixa e instala o aplicativo de desktop, verifica se o login corporativo funciona e distribui o aplicativo para seus usuários.
Primeiro, baixe o aplicativo do console Amazon Quick.
Para baixar o aplicativo para desktop
-
No console Amazon Quick, no painel de navegação esquerdo, escolha Extensões. Se você não vê Extensões, escolha Mais para encontrá-las.
-
Selecione a extensão Quick Desktop que você criou na Etapa 3.
-
Escolha o ícone de mais opções (... ) para a extensão.
-
Escolha Baixar para Windows ou Baixar para Mac, dependendo do seu sistema operacional.
Em seguida, instale o aplicativo. Para obter instruções de instalação, consulte Introdução.
Depois de instalar o aplicativo, verifique se o login corporativo funciona.
Para verificar o login corporativo
-
Abra o aplicativo de desktop Amazon Quick.
-
Na tela de login, escolha Continuar com SSO.
-
(Opcional) Região da AWS Selecione o seu na lista ou escolha Dinâmico para que o aplicativo detecte sua região automaticamente.
-
Autentique-se com suas credenciais corporativas. O aplicativo redireciona para seu provedor de identidade e, em seguida, retorna à tela inicial após a autenticação ser bem-sucedida.
dica
Se o login falhar, verifique os valores inseridos na Etapa 2 em relação aos endpoints do OIDC e à ID do cliente da Etapa 1. Se algum valor estiver incorreto, exclua o acesso à extensão em Permissões → Acesso à extensão no console de administração do Amazon Quick e repita a Etapa 2 com os valores corretos. Para obter mais ajuda, consulte Solução de problemas de login corporativo para o Amazon Quick no desktop.
Finalmente, depois de verificar a configuração, distribua o aplicativo para seus usuários. Direcione-os Introdução para obter instruções de download, instalação e login. Os usuários escolhem Continuar com o SSO e fazem login com suas credenciais corporativas — nenhuma configuração adicional por usuário é necessária.
