Ligar Context Handler / FKA com SAML 2.0 (Modelo)

Ligue o FoxIDs ao Context Handler com o modelo de método de autenticação SAML 2.0 Context Handler / FKA. O modelo configura OIOSAML 3 para o ambiente de teste ou produção do Context Handler.

O Context Handler é o intermediário de identidade dinamarquês para a federação municipal, denominado Fælleskommunal Adgangsstyring (FKA).

Ligar ao Context Handler

Combine o método de autenticação com um registo de aplicação OpenID Connect para que o FoxIDs possa ligar SAML 2.0 a OpenID Connect. As aplicações selecionam o método de autenticação Context Handler e recebem as claims configuradas.

No ambiente de teste do Context Handler, pode iniciar sessão com o IdP de teste do FoxIDs ou através de outros municípios de teste. Também pode configurar o seu próprio Identity Provider de teste FoxIDs com um registo de aplicação SAML configurado manualmente.

Selecionar o IdP de teste do FoxIDs

Pode experimentar o Context Handler com a aplicação web de exemplo online selecionando Log in e Danish Context Handler TEST ou Danish Context Handler. Em teste, selecione FoxIDs - test-corp na página de início de sessão do Context Handler. Consulte a configuração em FoxIDs Control: test-corp. O endereço de e-mail e a palavra-passe da conta de leitura são apresentados na página de início de sessão. Selecione o ambiente context-handler, context-handler-test ou context-handler-idp-test.

Ambientes separados

Utilize ambientes FoxIDs separados para Context Handler em teste e produção. Cada ligação precisa do seu próprio certificado OCES3 de produção, incluindo a ligação de teste. Siga as orientações da KOMBIT sobre certificados e utilize um certificado único para cada sistema registado e ambiente.

O certificado pertence a todo o ambiente FoxIDs. O carregamento de um certificado através do modelo altera o certificado de assinatura do ambiente e pode afetar outras ligações. Ligue os ambientes dedicados ao seu ambiente de aplicações através de Environment Links.

Ligar Context Handler através de ambientes separados

Para criar um ambiente, abra o seletor Environments no FoxIDs Control Client, clique em New environment, introduza um nome e clique em Create.

Um Identity Provider de teste para Context Handler também deve estar no seu próprio ambiente com um certificado OCES3 de produção único.

Criar o método de autenticação Context Handler

  1. Selecione o ambiente FoxIDs dedicado e abra Authentication.

  2. Clique em New authentication e selecione Connect to Context Handler / FKA.

    Selecionar o modelo do método de autenticação Context Handler / FKA

  3. Introduza um nome, por exemplo Context Handler test.

  4. Selecione Context Handler environment: Test ou Production.

    Nome, ambiente e ligação ao portal de administração do modelo Context Handler

  5. Tanto o ambiente de teste como o de produção exigem um certificado OCES3 de produção com a respetiva chave privada, disponível através da administração de certificados. O modelo reutiliza um certificado correspondente do ambiente. Caso contrário, carregue o seu certificado (.p12), introduza a palavra-passe e clique em Read and use certificate.

    Selecione Change certificate para escolher outro certificado. Um aviso sobre o tipo de certificado indica que é esperado um certificado OCES3 de produção; pode guardar o certificado carregado na mesma. Os certificados expirados são apresentados a vermelho e devem ser substituídos por um certificado válido. O certificado selecionado é aplicado quando clica em Create ou Update.

    Para gerir o certificado no separador Certificates do ambiente em vez de o fazer no modelo, ative Show advanced e desative Update the environment certificate.

    Carregar um certificado OCES3 de produção no modelo Context Handler

  6. Reveja os atributos e privilégios e introduza o nome do seu serviço em Service name in metadata. Este nome obrigatório é incluído nos metadados SP partilhados com o Context Handler.

  7. Adicione um contacto administrativo, incluindo empresa e endereço de e-mail.

    Privilégios, nome do serviço e dados do contacto administrativo do Context Handler

  8. Clique em Create.

O ambiente selecionado determina o URL dos metadados IdP:

Ambiente Context Handler Metadados IdP
Teste Metadados de teste
Produção Metadados de produção

O FoxIDs atualiza automaticamente os metadados a cada 24 horas, incluindo os certificados de assinatura do Context Handler. Os URL são publicados na documentação Context Handler da KOMBIT.

Atributos e privilégios

O modelo solicita e reencaminha estes atributos:

  • https://data.gov.dk/model/core/specVersion
  • https://data.gov.dk/concept/core/nsis/loa
  • dk:gov:saml:attribute:AssuranceLevel
  • https://data.gov.dk/model/core/eid/professional/uuid/persistent
  • https://data.gov.dk/model/core/eid/professional/cvr
  • https://data.gov.dk/model/core/eid/professional/orgName
  • https://data.gov.dk/model/core/eid/email
  • https://data.gov.dk/model/core/eid/firstName
  • https://data.gov.dk/model/core/eid/lastName
  • https://data.gov.dk/model/core/eid/privilegesIntermediate

Consulte o perfil de atributos OIOSAML 3 do Context Handler para obter detalhes sobre os atributos suportados.

Request CPR attribute está disponível em Show advanced e desativado por predefinição. Ative a opção para solicitar e reencaminhar https://data.gov.dk/model/core/eid/cprNumber quando a aplicação precisar dele. Os atributos efetivamente devolvidos dependem da ligação Context Handler e do fornecedor de identidade a montante.

DK XML privilege to JSON está ativado por predefinição. Converte o XML de privilégios recebido em JSON legível através da transformação de privilégios DK. Desative a opção para reencaminhar a claim de privilégios original. Isto não altera as funções atribuídas no Context Handler.

O FoxIDs mapeia claims SAML para claims JWT nas aplicações OpenID Connect. Configure as claims emitidas pela aplicação para incluir as claims mapeadas necessárias; consulte claims. Por exemplo, a claim de privilégios é mapeada para privileges_intermediate.

Registar o sistema destinado aos utilizadores no Context Handler

  1. Abra o portal de administração Context Handler para teste ou produção.
  2. Selecione IT-systems (IT-systemer) e Add IT-system (Tilslut it-system).
  3. Preencha os dados do sistema e selecione User system (Brugervendt system).
  4. No separador User system, selecione SAML 2.0.
  5. Selecione o perfil OIOSAML3, o nível NSIS necessário e, opcionalmente, um nível de garantia NIST.
  6. No FoxIDs, copie SAML 2.0 method URL de Application information na parte superior do modelo guardado.
  7. Registe este URL como NSIS SAML metadata URL no Context Handler. Utilize o URL para permitir a obtenção automática de alterações aos metadados e certificados. O modelo também permite descarregar os metadados.
  8. Preencha os campos restantes, aceite os termos e guarde.

Consulte o guia de administração da KOMBIT para conhecer o procedimento relativo ao URL dos metadados e à substituição de certificados.

Experimentar a ligação

Abra o método de autenticação guardado e selecione Test authentication, seguido de Start the test. No ambiente de teste do Context Handler, selecione o IdP de teste do FoxIDs ou outro município de teste e inicie sessão com um utilizador de teste. Um início de sessão bem-sucedido regressa à aplicação de teste com as claims recebidas. Também pode experimentar terminar a sessão e inspecionar o JSON de privilégios devolvido.

Configuração SAML padrão

Selecione Switch to standard SAML settings num método de autenticação guardado para editar a configuração SAML completa. Isto interrompe as atualizações automáticas de certificados do modelo. Ao regressar ao modelo, são reaplicadas as predefinições e mantida a escolha guardada para a atualização de certificados.

Para os passos de configuração manual, consulte Context Handler / FKA (Configuração padrão legada).

Configurar um Identity Provider de teste para Context Handler

A configuração do seu próprio Identity Provider de teste é opcional. Também pode iniciar sessão através de outros municípios de teste disponíveis no ambiente de teste do Context Handler.

Para configurar o FoxIDs como o seu próprio Identity Provider de teste, adicione o Context Handler como relying party SAML 2.0, conforme descrito abaixo.

Utilize um ambiente separado para os seus utilizadores de teste. No separador Certificates desse ambiente, selecione Contained certificates, carregue o seu certificado OCES3 de produção único como certificado principal e introduza a palavra-passe.

1 - Comece por criar um registo de aplicação SAML 2.0 no FoxIDs Control Client

  1. Selecione o separador Applications

  2. Clique em New application

  3. Selecione Show advanced

  4. Selecione Web Application (SAML 2.0)

  5. Adicione o Name, por exemplo Context Handler IdP

  6. Descarregue os metadata RP do Context Handler, onde pode encontrar endpoints e o certificado a trusted. Metadata de teste: https://n2adgangsstyring.eksterntest-stoettesystemerne.dk/runtime/saml2auth/metadata.idp?samlprofile=nemlogin3 O certificado está codificado em base64 e pode ser convertido num ficheiro de certificado .cer com a ferramenta de certificados FoxIDs.

  7. Adicione Application issuer https://saml.n2adgangsstyring.eksterntest-stoettesystemerne.dk/runtime e os metadata

  8. Adicione Assertion consumer service (ACS) URL https://n2adgangsstyring.eksterntest-stoettesystemerne.dk/runtime/saml2auth/consume.idp dos metadata Context Handler SAML 2.0 application

  9. Clique em Register

  10. Leia o Metadata URL e guarde-o para mais tarde

  11. Clique em Close

  12. A configuração detalhada abre-se; selecione Show advanced no canto superior direito desta secção de configuração

  13. Ative Absolute ACS URL

  14. Defina Encrypt authn response como Yes

  15. Adicione o certificado de encriptação dos metadata em Encryption certificate

  16. Defina NameID format como urn:oasis:names:tc:SAML:1.1:nameid-format:X509SubjectName

  17. Adicione Logged out URL https://n2adgangsstyring.eksterntest-stoettesystemerne.dk/runtime/saml2auth/signoffresponse.idp dos metadata

  18. Adicione Single logout out URL https://n2adgangsstyring.eksterntest-stoettesystemerne.dk/runtime/saml2auth/signoffrequest.idp dos metadata

  19. Defina Logout request binding e Logout response binding como redirect

  20. Defina os claims OIOSAML3 que devem ser emitidos para o Context Handler em Issue claims

Os seguintes claims são os mais usados:

  • https://data.gov.dk/model/core/specVersion
  • https://data.gov.dk/model/core/kombitSpecVer
  • https://data.gov.dk/concept/core/nsis/loa
  • https://data.gov.dk/model/core/eid/professional/cvr
  • https://data.gov.dk/model/core/eid/privilegesIntermediate
  1. Adicione o certificado de assinatura dos metadata em Signature validation certificate
  2. Opcionalmente defina Certificate validation mode como Chain trust se o certificado root OCES3 for trusted na sua plataforma Defina Certificate revocation mode como Online
  3. Defina Authn response sign type como Sign assertion
  4. Configure um Custom IdP issuer; o issuer pode opcionalmente começar com https://saml.. O issuer neste exemplo é https://saml.foxids.com/test-corp/context-handler-test-idp/
  5. Selecione Yes em Add logout response location URL in metadata
  6. Selecione Yes em Include the encryption certificate in metadata
  7. Em Contact persons in metadata, clique em Add contact person e depois em Administrative para adicionar uma pessoa de contacto administrativa Context Handler SAML 2.0 application
  8. Clique em Update
  9. Vá ao topo da secção da aplicação SAML 2.0
  10. Encontre os metadata do test IdP em SAML 2.0 Metadata, neste caso https://foxids.com/test-corp/context-handler-idp-test/ch-idp(*)/saml/idpmetadata Os metadata do test IdP são usados para configurar o identity provider do Context Handler.

2 - Depois vá ao portal de administração do Context Handler em Test

  1. Selecione IT-systems
  2. Clique em Add IT-system
  3. Preencha os campos e selecione Identity Provider
  4. Vá ao separador Identity Provider
  5. Selecione Context Handler with NSIS e remova a seleção de Context Handler without NSIS
  6. Selecione OIOSAML3 como perfil OIOSAML e nível NSIS
  7. Adicione o test IdP-metadata URL, neste caso https://foxids.com/test-corp/context-handler-idp-test/ch-idp(*)/saml/idpmetadata.
  8. Preencha o restante, aceite os termos e clique em Save

É obrigatório estar registado como sua própria test authority, em dinamarquês egen test myndighed, no ambiente de teste para adicionar um acordo de federação. Um acordo de federação, em dinamarquês føderationsaftaler, é necessário para ativar o identity provider no Context Handler.

3 - Adicione a transformação de claims no FoxIDs Control Client

Crie os claims que têm de ser emitidos para o Context Handler em claim transforms.

  1. Volte à aplicação SAML 2.0 Context Handler IdP
  2. Selecione o separador Claim transforms
  3. Adicione um claim Constant https://data.gov.dk/model/core/specVersion com o valor OIO-SAML-3.0
  4. Adicione um claim Constant https://data.gov.dk/model/core/kombitSpecVer com o valor 2.0
  5. Adicione um claim Constant de níveis de assurance, loa, https://data.gov.dk/concept/core/nsis/loa com, por exemplo, o valor Substantial ou leia o claim através do pipeline de claims

Context Handler SAML 2.0 application registration

  1. Adicione um claim Concatenated para substituir o claim NameID http://schemas.xmlsoap.org/ws/2005/05/identity/claims/nameidentifier por uma versão concatenada do número CVR, display name e unique user ID
  2. Selecione Action Replace claim
  3. Concatene os claims:
    • https://data.gov.dk/model/core/eid/professional/cvr
    • http://schemas.xmlsoap.org/ws/2005/05/identity/claims/givenname
    • http://schemas.xmlsoap.org/ws/2005/05/identity/claims/surname
    • http://schemas.xmlsoap.org/ws/2005/05/identity/claims/nameidentifier
  4. Defina Concatenate format string como C=DK,O={0},CN={1} {2},Serial={3} Context Handler SAML 2.0 application registration
  5. Clique em Update

4 - Adicione mapeamentos de claim SAML 2.0 para claim JWT no FoxIDs Control Client

O FoxIDs converte internamente claims SAML 2.0 em claims JWT. O Context Handler usa um conjunto de claims SAML 2.0 definido pelo OIOSAML3 e os correspondentes mapeamentos JWT precisam de ser adicionados no ambiente.

  1. Vá ao separador Settings e a Claim mappings
  2. Clique em Add claim mapping para todos os claims configurados no passo 1.20; pode criar os seus próprios nomes curtos de claims JWT se não existir um nome standard, ou editar os claim mappings se já existirem
  3. Clique em Update

5 - Adicione utilizadores de teste no FoxIDs Control Client

Pode adicionar utilizadores de teste com claims de teste no separador Users e no sub separador Internal Users.

Os claims de teste em utilizadores de teste são baseados em JWT e mapeados para claims SAML 2.0.

Cada utilizador de teste precisa de ter um claim CVR cvr, um claim given name given_name, um claim family name family_name e opcionalmente um claim privilege com um valor string XML de DK privilege codificado em base64.

Test user 1

Se o utilizador tiver de ter a função Job function role, em dinamarquês Jobfunktionsrolle, http://foxids.com/roles/jobrole/test-corp-admin_access/1, o DK privilege XML será, com número CVR de teste: 11111111:

<?xml version="1.0" encoding="UTF-8"?>
<bpp:PrivilegeList xmlns:bpp="http://digst.dk/oiosaml/basic_privilege_profile" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" >
    <PrivilegeGroup Scope="urn:dk:gov:saml:cvrNumberIdentifier:11111111">
        <Privilege>http://foxids.com/roles/jobrole/test-corp-admin_access/1</Privilege>
    </PrivilegeGroup>
</bpp:PrivilegeList>