Administração da Plataforma
...
Autenticação
MFA
procedimento operacional de infraestrutura integração com entra id (antigo azure 3d) para autenticação oauth 2 0 prĆ© requistos antes de iniciar a integração com o entra id para autenticação oauth 2 0, Ć© essencial garantir que vocĆŖ tenha atendido a uma sĆ©rie de prĆ© requisitos abaixo, detalhamos cada um deles configuração do entra id 1 1 produtos utilizados na integração do entra idcom o 4biz pacotes utilizados nesse processo produto versĆ£o nome do pacote helium 2 5 1+ helium 2 5 1 war builder 1 3 7 8 + 4biz builder 1 3 7 8 war inventory (inv) 3 0 9 citsmartinventory 3 0 9 war events evm 3 0 9 evm 3 0 9 war imagens docker homologadas produto url para download das imagens docker itsm registry cloud4biz com/parceiros/itsmops 2 5 1 1 mongo docker io/mongo 5 0 6 solr registry cloud4biz com/parceiros/solr 9 4 1 tika registry cloud4biz com/parceiros/tika\ latest graphmail registry cloud4biz com/parceiros/graphmail 1 1 7 necessĆ”rio a inclusĆ£o dos seguintes paramentros abaixo no arquivo docker compose yml \##### parametros do inv e evm authentication protocol=both authentication create user=true ## false = login, login, login, login, etc ## true = login ou login login case sensitive=false 1 2 conta do azure certifique se de possuir uma conta vĆ”lida no azure se ainda nĆ£o tiver uma, vocĆŖ pode criar uma gratuitamente no portal do azure 1 3 assinatura do entra id verifique se vocĆŖ tem acesso a uma assinatura do entra id geralmente, as assinaturas do azure incluem o entra id automaticamente, mas Ć© importante verificar a disponibilidade 1 4 permissƵes de administrador Ć© fundamental possuir permissƵes de administrador no portal do azure para registrar aplicativos e configurar permissƵes no entra id 1 5 conhecimento bĆ”sico de oauth 2 0 e openid connect recomendamos ter um entendimento bĆ”sico dos conceitos de oauth 2 0 e openid connect antes de prosseguir isso inclui familiaridade com os conceitos de autorização, fluxos de autenticação, tokens de acesso e identificação de usuĆ”rio 1 6 ambiente de desenvolvimento configure um ambiente de desenvolvimento adequado para testar e integrar a autenticação oauth 2 0 com o entra id isso pode incluir a instalação de um ide (ambiente de desenvolvimento integrado), como visual studio code, e um servidor local para hospedar seu aplicativo durante o desenvolvimento 1 7 configuração do aplicativo de destino antes de registrar o aplicativo no entra id, Ć© necessĆ”rio ter informaƧƵes bĆ”sicas sobre o aplicativo, incluindo nome, descrição e url de redirecionamento certifique se de ter definido claramente os escopos de permissĆ£o necessĆ”rios para acessar recursos protegidos em nome dos usuĆ”rios 1 8 configuração de rede e seguranƧa verifique se todas as configuraƧƵes de rede e seguranƧa necessĆ”rias foram implementadas para permitir comunicação segura entre sua plataforma e o entra id isso pode incluir configuraƧƵes de firewall, polĆticas de acesso e criptografia de dados 1 9 documentação oficial do entra id consulte a documentação oficial do entra id para obter orientaƧƵes detalhadas sobre como registrar um aplicativo, configurar permissƵes e implementar a autenticação oauth 2 0 a documentação pode fornecer insights valiosos e soluƧƵes para possĆveis problemas durante o processo de integração garantir que todos esses prĆ© requisitos sejam atendidos ajudarĆ” a facilitar uma integração suave e bem sucedida do entra id em sua plataforma, proporcionando uma experiĆŖncia de autenticação segura e eficiente para seus usuĆ”rios registro do aplicativo no portal da azure 2 1 realizar o registro do aplicativo no portal da azure pela seguinte url https //portal azure com/#home 2 2 serĆ” redirecionado para o portal de login da microsoft azure entre com a conta de usuĆ”rio que tenha permissĆ£o no portal da azure ad para realizar as configuraƧƵes de aplicativo entre com a senha do usuĆ”rio por seguranƧa, selecione a opção nĆ£o, para nĆ£o permanecer conectado 2 3 acessando a tela inicial do portal da azure selecione a opção gerenciar o microsoft entra id na opção āexibirā conforme a imagem abaixo 2 4 realizar o registro de aplicativo para integração do protocolo oauth2 com plataforma 4biz 4biz , selecione a opção āregistro de aplicativoā selecione a opção ānovo registroā nessa tela a configuração realizada baseada no cenĆ”rio da run2biz, preencha os dados do item 1 ao item 5, conforme a imagem abaixo de acordo com o cenĆ”rio do seu ambiente 1 escolha um nome amigĆ”vel para registro do aplicativo itsm 2 escolha a opção de quem pode usar ou acessar esta api contas somente neste diretório organizacional (somente run2biz corporation ā Ćŗnico locatĆ”rio) segue a ajuda disponibilizada pela propria microsoft para escolha do tipo de conta de acordo com o seu ambiente noƧƵes bĆ”sicas sobre os tipos de contas diferentes contas somente nesse diretório organizacional (somente run2biz corporation Ćŗnico locatĆ”rio) todas as contas de usuĆ”rio e convidado em seu diretório podem usar seu aplicativo ou api use essa opção se seu pĆŗblico alvo for interno em sua organização contas em qualquer diretório organizacional (qualquer locatĆ”rio da microsoft entra id multilocatĆ”rio) todos os usuĆ”rios com uma conta corporativa ou de estudante da microsoft podem usar o aplicativo ou a api isso inclui escolas e empresas que usam o office 365 use essa opção se o publico alvo for de clientes comerciais ou educacionais e para habilitar a multilocação contas em qualquer diretório organizacional (qualquer locatĆ”rio da microsoft entra id multilocatĆ”rio) e contas pessoais da microsoft por exemplo skype todos os usuĆ”rios com uma conta profissional, de estudante ou pessoal da microsoft podem usar o aplicativo ou api isso inclui escolas e empresas que usam o office 365, bem como contas pessoais que sĆ£o usadas para entrar em serviƧos com skype use essa opção para direcionar ao maior conjunto possĆvel de identidade da microsoft e para habilitar a multilocação somente contas pessoais microsoft contas pessoais para entrar em serviƧos como sype use essa opção para direcionar ao maior conjunto possĆvel de identidade da microsoft devido a diferenƧas temporĆ”rias na funcionalidade, vocĆŖ pode ver erro se tentar alternar entre audiĆŖncias com suporte após registro de aplicativo 3 uri de redirecionamento web 4 url que o aplicativo retornara Ć consulta ex https //infra4biz cloud4biz com/4biz/login/oauth2/code/itsm 5 confira as informaƧƵes acima e clique em registrar 2 5 para realizar a integração com o entra id serĆ£o necessarias o envio das seguintes informaƧƵes da aplicação registrada para configuração na plataforma do 4biz 4biz nome da aplicação itsm id do aplicativo (cliente) run2b1zts 4bd9 b6b4 a962 t404h2b6971s id do diretório (locatĆ”rio) a962t40d be48 530d 29b1 t69h714h80bs 2 6 siga os passos do item 1 ao 4 de cada imagem abaixo para realizar as configuraƧƵes de permissƵes de apis 2 7 siga os passos do item 1 ao 5 para adicionar as seguintes permissƵes na aplicação email openid profile user read 2 8 Ć© necessĆ”rio conceder a confirmação de consentimento do administrador do entra id para a aplicação, siga os passos do item 1 ao 3 conforme imagem abaixo 1 verifique se as 4 permissƵes estĆ£o vinculadas a aplicação; 2 clique em conceder consentimento do administrador para run2biz corporation; 3 clique em sim para conceder a confirmação de consentimento do administrador após ser concedido o consentimento do administrador, o campo status ficarĆ” conforme o item 2 da imagem abaixo 2 9 ainda no registro de aplicativo, na opção ācertificados e segredosā, vamos gerar o token para a aplicação siga os passos do item 1 ao 5 para geração do token de acordo com o seu ambiente lembre se o segredo do campo "valor" nĆ£o serĆ” exibido posteriormente, exceto imediatamente após a criação salve o segredo quando criado antes de sair dessa pĆ”gina, pois serĆ” utilizado para a integração com o 4biz 4biz 2 10 salve as informaƧƵes dos sequintes campos para configurar o oauth2 no 4biz 4biz id do cliente run2b1zts 4bd9 b6b4 a962 t404h2b6971s id do diretório (locatĆ”rio) a962t40d be48 530d 29b1 t69h714h80bs chave secreta do cliente campo āvalorā eve8q fha8sc6u6d54w\ jggmtlv3sawwcphnwabl autenticação oauth 2 0 3 1 acesse a url da aplicação do 4biz 4biz para proceder com a configuração acesse o ambiente https //infra4biz cloud4biz com/4biz/webmvc/login com um usuĆ”rio que tenha permissĆ£o para configurar o oauth2 na plataforma 3 2 verificar o id do perfil de acesso default atribuĆdo após a autenticação dos usuĆ”rios no sistema na tela do 4biz 4biz clique nas seguintes opƧƵes 1 clique no menu sanduiche; 2 no campo de pesquisa digite o inicio da palavra āperfilā; 3 clique no campo āperfil acessoā 1 clique no campo āpesquisa de perfil de acessoā; 2 clique no campo āpesquisarā; 3 nesse exemplo vamos utilizar o āid 18 ā necessĆ”rio para configuração dos proximos passos 3 3 verificar o id do grupo de acesso default atribuĆdo após a autenticação dos usuĆ”rios no sistema na tela do 4biz 4biz clique nas seguintes opƧƵes 1 clique no menu sanduiche; 2 no campo de pesquisa digite o inicio da palavra āgrupā; 3 clique no campo āgrupoā 1 clique no campo ānomeā; 2 no campo de pesquisa, vamos procurar pelo grupo de exemplo keycloack digite a palavra ākeyā; 3 verifique o nome do grupo keycloack e o āid 1102ā necessĆ”rio para configuração dos proximos passos 3 4 configurar os parĆ¢metros id perfil de acesso padrĆ£o do usuĆ”rio e id do grupo padrĆ£o na tela do 4biz 4biz clique nas seguintes opƧƵes 1 clique no menu sanduiche; 2 no campo de pesquisa digite o inicio da palavra āparaā; 3 clique no campo āparĆ¢metrosā 1 clique na pesquisa e digite a palavra āldapā; 2 no campo id 39 insira o valor do item 3 2 da documentação, nesse caso o valor serĆ” ā18ā; 3 no campo id 45 insira o valor do item 3 3 da documentação, nesse caso o valor serĆ” ā1102ā 3 5 configurar a integração do 4biz 4biz com o entra id atravĆ©s do protocolo oauth2 1 clique no menu sanduiche; 2 no campo de pesquisa digite o inicio da palavra āoauā; 3 clique no campo āoauth2ā 3 6 na tela do 4biz 4biz clique na opção ānovoā para iniciar a configuração do oauth2 3 7 configuração dos metodos de oauth2 na plataforma do 4biz 4biz siga os passos do item 1 ao 14 de acordo com as informaƧƵes geradas no procedimento do passo 2 registro do aplicativo no portal do entra id tipo de autenticação > oauth2 externa provider > outros domĆnio > itsm nome do cliente > itsm id do cliente > run2b1zts 4bd9 b6b4 a962 t404h2b6971s chave secreta do cliente > eve8q fha8sc6u6d54w\ jggmtlv3sawwcphnwabl situação > ativo url de autenticação > https //login microsoftonline com/a962t40d be48 530d 29b1 t69h714h80bs/oauth2/v2 0/token uri autorização > https //login microsoftonline com/a962t40d be48 530d 29b1 t69h714h80bs/oauth2/authorize uri informaƧƵes do usuĆ”rio > https //graph microsoft com/oidc/userinfo escopo > user read+openid+profile+email atributo identificador do usuĆ”rio > email marcar a check box > renovar o token automaticamente clicar em > gravar 3 8 após gravação das configuraƧƵes, o metodo de autenticação estarĆ” salvo 3 9 abra o navegador em uma aba anĆ“nima para testar a configuração observe que agora o domĆnio itsm que configuramos no passo 3 7 estarĆ” disponivel conforme imagem abaixo 3 10 clique no domĆnio itsm o seu acesso serĆ” redirecinado para o portal da microsoft onde vocĆŖ deverĆ” entrar com o seu usuĆ”rio e senha caso o usuĆ”rio possua duplo fator de autenticação habilitado, serĆ” pedido o token de verificação após a realização do login bem sucedido no portal da microsoft, vocĆŖ serĆ” redirecionado automaticamente com acesso a plataforma do 4biz 4biz isso significa que toda a configuração realizada para a integração com o entra id e a plataforma do 4biz 4biz estĆ£o funcionando corretamente 4\ consideraƧƵes finais a integração do 4biz 4biz com o entra id usando oauth 2 0 oferece uma maneira segura e eficaz de autenticar usuĆ”rios em aplicativos e serviƧos ao seguir os passos detalhados neste documento, vocĆŖ poderĆ” configurar com sucesso a autenticação oauth 2 0 em sua plataforma, garantindo uma experiĆŖncia de usuĆ”rio fluida e segura para mais informaƧƵes e suporte tĆ©cnico, entre em contato conosco esse documento oferece uma visĆ£o abrangente das etapas necessĆ”rias para configurar a integração com o entra id, fornecendo informaƧƵes tĆ©cnicas detalhadas que podem ser compartilhadas com os clientes para orientação referĆŖncia https //learn microsoft com/en us/azure/app service/configure authentication provider ad?tabs=workforce tenant