> For the complete documentation index, see [llms.txt](https://docs.linuxcontrolcenter.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.linuxcontrolcenter.com.br/conf-integrations/user-management/provedores/saml/cisco_duo.md). # SAML Cisco Duo ## Requisitos Linux Control Center = 2.12.X ou Superior\ Provedor de Single Sign-On (SSO) pré configurado (Cisco Duo) ## Overview O Linux Control Center permite configurar um provedor de início de sessão único (SSO) para a Console, proporcionando um acesso seguro e prático. O LCC oferece autenticação na Console por meio de LDAP e SAML. * Veja a imagem que representa o fluxo de autenticação. ![](/files/zUvWNvzoDCczSSNiCZZW) ## Objetivo O objetivo deste documento é apresentar o passo a passo para configurar um provedor de acesso à Console do LCC utilizando um provedor SAML. ## Configuração do Aplicativo no Cisco Duo 1. Acesse a estrutura do Cisco Duo do seu ambiente e crie um Aplicativo com as seguintes configurações: * *Application Type* = Generic SAML Service Provider - Single Sign-On ![](/files/rYQTMQ13nXlkRb5kVENi) ### Service Provider 1. O campo *Assertion Consumer Service (ACS) URL* deve ser preenchido com o endpoint do campo **URL Assertion Consumer Service**. Esta URL é gerada após criar o item SAML no Linux Control Center. Esta é a URL em que o Cisco Duo fará a autenticaçao. * Exemplo: ![](/files/5o2eVFSMYKbnFuAvY7d9) ### SAML Response 1. Configure os campos **NameID format** e **NameID attribute**. * Exemplo: NameID attribute ![](/files/zsj0ocJ4ktUU7Eo6d6Cs) ### Map attributes 1. o mapeamento de atributos *IdP Attribute*, *SAML Response Attribute* e *Attribute Name* podem ser configurados conforme a necessidade de seu ambiente. Exemplo; * ** - email * ** - userid * ** - username * ** - name ![](/files/T3fIbCLeAWgTjdyNolw7) ## Permissionamento de Usuário no LCC * Ao utilizar o login via Cisco Duo para acessar o Linux Control Center (LCC), o usuário será automaticamente criado na console do LCC, porém sem nenhuma permissão atribuída. Para garantir o acesso adequado aos recursos, é necessário criar um Grupo na Console do LCC com as regras de acesso desejadas e associar esse grupo na configuração da integração com o Cisco Duo. Dessa forma, os usuários autenticados receberão as permissões conforme definidas no grupo vinculado. 1. Clique em **Config** no menu lateral esquerdo. ![](/files/Mra2gJYGy0r3ftQcvMBV) 2. Clique em **User Group**. ![](/files/lPbLcWC33XidzCq4I5BP) 3. Clique em **Create**. ![](/files/UHI8nkwtmhNIX1sCFawq) 4. Insira um nome para o Grupo no campo **Name** ![](/files/O5021wF2JGhK88kCFl0v) 5. Clique em **Configure Permissions** e escolha as permissões em que deseja habilitar para os usuários do grupo. ![](/files/ADLf1MIm42xdyAg8kMfM) 6. Clique em **Save** para criar o grupo. ![](/files/nnLJAcXpbUZzS47mCzT2) 7. O grupo será listado na tela **User Groups**. ![](/files/XvsYfFrQjdxJc2oJJKN7) ## Configuração do Cisco Duo no LCC 1. Clique em **Config** no menu lateral esquerdo do LCC. ![](/files/Mra2gJYGy0r3ftQcvMBV) 2. Clique em **Provider**. ![](/files/cCmAiEzY8eNE3GECytdD) 3. Clique em **SAML**. ![](/files/rihT0npxg2zzEQOsKeNU) 4. Clique em **Create** ![](/files/14WWVtilCacc63X2Q1sY) 5. Acesse o Cisco Duo do seu ambiente e insira os dados do *Aplicativo* nos campos conforme orientação abaixo: * **Name:** Este campo será o nome do botão na tela de Login com a logo do Cisco Duo. * **Entity ID:** Insira o ID da entidade do *Aplicativo* configurado no Cisco Duo. * **IDP Metadata URL:** Insira a URL de metadados do seu Provedor de Identidade. * **Certificate:** Insira o certificado do Aplicativo configurado no Cisco Duo. * **LCC Groups:** Escolha o *Grupo de Permissões* que será atribuído aos usuários que acessarem a Console por meio desta integração com o Cisco Duo. ![](/files/fEnmLCLfLXb3beq7B41z) 6. Clique no botão **Select an Icon** e selecione o ícone *Cisco Duo* para definir o botão de Login na Console do LCC. ![](/files/k4pGGkj1FfnURb7lJl6y) ### Attribute Map 1. Clique em **Next** para acessar a as configurações de Attribute Map. ![](/files/rF8XyK7IUvSPEAJajdrR) 2. Preencha o campo *User Identifier Attribute*. Este campo define o usuário do Provedor de Identidade que será responsável por validar a autenticação. É possível definir uma chave para validar a resposta do IDP. ![](/files/O7rMDpsjnncwFViZHXo0) 3. Clique em **Next** novamente e marque as opções conforme necessidade. ![](/files/xsNqP0chaTFjse3IxGnu) 4. Clique em **Salvar** para criar o provedor na Console do LCC. ![](/files/Brtq1AtYQQYhrZ34j9hi) ### Cadastro do Endpoint no IDP {% hint style="warning" %} Esta etapa é crucial na configuração de um provedor de identidade, é necessário cadastrar o Endpoint do LCC no seu *Provedor de Identidade* para que o LCC tenha permissão para realizar as consultas. {% endhint %} 1. Clique no Provedor de Identidade criado e copie os valores dos campos *URL Assertion Consumer Service* e *URL Single Logout Service* e registre-os no seu Provedor de Identidade. ![](/files/sGr5e8Ir1jzkCkxiFV8U) ### Permissão para o Provedor 1. Clique em **Config** no menu lateral esquerdo. ![](/files/xWA7sDret6munZBRDH2v) 2. Clique em **Authentication** ![](/files/9fklHvUvDeBLuf7SPLVz) 3. Clique na Aba **Providers**, selecione o provedor e mova-o para a tabela do lado direito. ![](/files/mee6IGeJzH439O8Vmve5) 4. Clique em **Save** para definir o Provedor Cisco Duo como um método de autenticação válido. ![](/files/hq3st9Ipn4KsKwIJPQhE) ## Acesso com Provedor de Identidade 1. Faça logout com o usuário atual e clique no botão do Provedor de Identidade criado e o LCC fará a consulta e a leitura da resposta do SAML para validar o acesso à Console. ![](/files/EKEl75seXT2qAJLswrL8)