--- title: Configurar o Okta no CITSmart slug: cit-9/configurar-o-okta-no-citsmart description: Learn how to configure Okta authentication for users in CITSmart with this step-by-step guide. Create an Okta account, set up the CITSmart application within Okta, assign users, configure the CITSmart file, synchronize users, and establish the logout proc docTags: createdAt: 2021-10-26T19:21:31.000Z --- Este método de autenticação permite que se utilize os recursos do Okta para autenticar usuários da organização em uma instância **CITSmart**. Este documento explica os passos da configuração deste método. Para saber mais sobre o Okta acesse okta.com ## Antes de começar - [x] A configuração desta solução é um processo de diversas fases. A primeira fase é a criação de uma conta Okta. ## Procedimento *1º Passo: Criar uma conta Okta:* 1. Acessar o site: [https://www.okta.com](https://www.okta.com); 2. Clicar em "Try Okta" e em seguida "Sign up today"; 3. Informar os dados essenciais (e-mail, nome e sobrenome); 4. Apertar o botão "Get Started" para concluir a operação. Em seguida, verificar o e-mail cadastrado (que enviará um link de acesso), acessar a conta com a senha temporária enviada e alterar a mesma para maior segurança dos dados; ::Image[]{src="https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/PSny54mLBxj5h7FrAx_kf_image.png" size="66" width="420" height="448" position="center" showCaption="false"} ![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/2woQLMfAyhrq7nMmoIlGj_image.png) *2º Passo: Criar a aplicação CITSmart dentro do Okta:* 1. Após concluído a etapa anterior, conectar-se ao Okta com a conta recém criada; 2. Clicar na aba "Applications e em seguida no botão "Add Application"; ![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/GSuKTYqIx6iYdDnZ1Mtf0_image.png) 1. Apertar em "Create New App"; ![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/KwLOlGTkthY0le35YTwxO_image.png) 1. Marcar a opção "SAML 2.0" e depois clicar no botão "Create"; 2. No campo "App name", adcionar o nome da aplicação e logo após, é necessário clicar no botão "Next"; 3. Configurar o caminho da aplicação e depois clicar no botão Next; 4. Marcar as opções "I'm an Okta customer adding an internal app" e "This is an internal app that we have created". Logo em seguida, clicar no botão "Finish". *3º Passo: Atribuir usuários a aplicação CITSmart do Okta:* 1. Concluído o passo anterior, é necessário clicar na aba "Applications > Applications" e em seguida em "Assign Applications" e optar pelo filtro chamado "People"; 2. Em seguida, é possível escolher o usuário que terá a permissão de acessar a aplicação que está sendo criada. Clicar então no botão "Assign" e posteriormente para finalizar, clicar em "Done"; *4º Passo: Incluir informações necessárias no CITSmart configurado no Okta:* 1. Será necessário configurar alguns dados no diretório do WildFly. Acessar o diretório, abrir a pasta "/standalone/configuration" e alterar o arquivo "citsmart.cfg". *5º Passo: Sincronizar usuário do Okta no CITSmart:* 1. Dentro do CITSmart, acessar o menu "Okta Config" e cadastrar uma nova configuração ao clicar no botão "Novo"; 2. Preencher os campos com as informações necessárias: - **Descrição:** introduzir uma definição desta nova configuração Okta; - **Alias:** incluir o domínio do usuário que será gravado na base. Exemplo: okta\\[administrador@citsmart.com](mailto\:administrador@citsmart.com); - **URL de domínio:** deverá incluir o mesmo valor (URL) que foi inserida na linha *OKTA\_URL* no arquivo "citsmart.cfg"; - **Token API:** incluir o mesmo valor do token inserido na linha *OKTA\_TOKEN* no arquivo "citsmart.cfg"; - **Grupo:** inserir o ID do grupo no qual o usuário sincronizado e gravado pertencerá no CITSmart; - **Perfil de Acesso:** inserir o ID do perfil no qual o usuário sincronizado e gravado pertencerá no CITSmart; - **ID da aplicação:** incluir o ID da aplicação. Esta informação pode ser recuperada na URL do Okta, conforme a figura abaixo: 3. Clicar no botão "Salvar" e em seguida "Sicronizar usuários" para efetuar a operação. *6º Passo: Configurar o Logout:* 1. Como o Okta não possui tela de logout, no parâmetro 377 do CITSmart podemos inserir algum endereço de página para redirecionar o usuário ao final da sessão; 2. Configurar o link para logout também no endereço (**Admin > Settings > Customization > Sign-Out-Page)** , em seguida marcar a opção "Usar a custom sign-out page". Então, deve-se inserir a URL ([https://localhost:8443/citsmart/saml/logout](https://localhost:8443/citsmart/saml/logout)) com as devidas adaptações (host e porta), conforme a imagem abaixo: ![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/HJPzyTAlHhGbomAr7GZiC_image.png) :::hint{type="warning"} **Importante: **Ao fazer o *logout* do CITSmart não deve ser realizado o *logout* do Okta, pois o usuário pode ter outras aplicações na sessão do Okta. Em contrapartida, se fizer o *logout* do Okta, a sessão do usuário no CITSmart será removida. ::: ## O que fazer a seguir Concluída a integração do Okta com o CITSmart, alguns parâmetros do CITSmart podem ser configurados para melhor personalizar esta integração: - O parâmetro 445 (Nome do grupo Administrador no Okta) permite escolher o grupo administrador na solução Okta. Se o usuário pertencer a este grupo escolhido, terá o perfil de acesso definido como administrador. Caso o mesmo não tenha um perfil definido, o sistema atribuirá o parâmetro 39 e caso este usuário já tenha um perfil definido no CITSmart, este se manterá.