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).
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.

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-testoucontext-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.
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
Selecione o ambiente FoxIDs dedicado e abra Authentication.
Clique em New authentication e selecione Connect to Context Handler / FKA.

Introduza um nome, por exemplo
Context Handler test.Selecione Context Handler environment: Test ou Production.

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.

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.
Adicione um contacto administrativo, incluindo empresa e endereço de e-mail.

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/specVersionhttps://data.gov.dk/concept/core/nsis/loadk:gov:saml:attribute:AssuranceLevelhttps://data.gov.dk/model/core/eid/professional/uuid/persistenthttps://data.gov.dk/model/core/eid/professional/cvrhttps://data.gov.dk/model/core/eid/professional/orgNamehttps://data.gov.dk/model/core/eid/emailhttps://data.gov.dk/model/core/eid/firstNamehttps://data.gov.dk/model/core/eid/lastNamehttps://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
- Abra o portal de administração Context Handler para teste ou produção.
- Selecione IT-systems (IT-systemer) e Add IT-system (Tilslut it-system).
- Preencha os dados do sistema e selecione User system (Brugervendt system).
- No separador User system, selecione SAML 2.0.
- Selecione o perfil OIOSAML3, o nível NSIS necessário e, opcionalmente, um nível de garantia NIST.
- No FoxIDs, copie SAML 2.0 method URL de Application information na parte superior do modelo guardado.
- 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.
- 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
Selecione o separador Applications
Clique em New application
Selecione Show advanced
Selecione Web Application (SAML 2.0)
Adicione o Name, por exemplo
Context Handler IdPDescarregue 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=nemlogin3O certificado está codificado em base64 e pode ser convertido num ficheiro de certificado.cercom a ferramenta de certificados FoxIDs.Adicione Application issuer
https://saml.n2adgangsstyring.eksterntest-stoettesystemerne.dk/runtimee os metadataAdicione Assertion consumer service (ACS) URL
https://n2adgangsstyring.eksterntest-stoettesystemerne.dk/runtime/saml2auth/consume.idpdos metadata
Clique em Register
Leia o Metadata URL e guarde-o para mais tarde
Clique em Close
A configuração detalhada abre-se; selecione Show advanced no canto superior direito desta secção de configuração
Ative Absolute ACS URL
Defina Encrypt authn response como Yes
Adicione o certificado de encriptação dos metadata em Encryption certificate
Defina NameID format como
urn:oasis:names:tc:SAML:1.1:nameid-format:X509SubjectNameAdicione Logged out URL
https://n2adgangsstyring.eksterntest-stoettesystemerne.dk/runtime/saml2auth/signoffresponse.idpdos metadataAdicione Single logout out URL
https://n2adgangsstyring.eksterntest-stoettesystemerne.dk/runtime/saml2auth/signoffrequest.idpdos metadataDefina Logout request binding e Logout response binding como redirect
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/specVersionhttps://data.gov.dk/model/core/kombitSpecVerhttps://data.gov.dk/concept/core/nsis/loahttps://data.gov.dk/model/core/eid/professional/cvrhttps://data.gov.dk/model/core/eid/privilegesIntermediate
- Adicione o certificado de assinatura dos metadata em Signature validation certificate
- Opcionalmente defina Certificate validation mode como Chain trust se o certificado root OCES3 for trusted na sua plataforma Defina Certificate revocation mode como Online
- Defina Authn response sign type como Sign assertion
- 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/ - Selecione Yes em Add logout response location URL in metadata
- Selecione Yes em Include the encryption certificate in metadata
- Em Contact persons in metadata, clique em Add contact person e depois em Administrative para adicionar uma pessoa de contacto administrativa

- Clique em Update
- Vá ao topo da secção da aplicação SAML 2.0
- 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/idpmetadataOs 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
- Selecione IT-systems
- Clique em Add IT-system
- Preencha os campos e selecione Identity Provider
- Vá ao separador Identity Provider
- Selecione Context Handler with NSIS e remova a seleção de Context Handler without NSIS
- Selecione OIOSAML3 como perfil OIOSAML e nível NSIS
- Adicione o test IdP-metadata URL, neste caso
https://foxids.com/test-corp/context-handler-idp-test/ch-idp(*)/saml/idpmetadata. - 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.
- Volte à aplicação SAML 2.0
Context Handler IdP - Selecione o separador Claim transforms
- Adicione um claim Constant
https://data.gov.dk/model/core/specVersioncom o valorOIO-SAML-3.0 - Adicione um claim Constant
https://data.gov.dk/model/core/kombitSpecVercom o valor2.0 - Adicione um claim Constant de níveis de assurance, loa,
https://data.gov.dk/concept/core/nsis/loacom, por exemplo, o valorSubstantialou leia o claim através do pipeline de claims

- Adicione um claim Concatenated para substituir o claim NameID
http://schemas.xmlsoap.org/ws/2005/05/identity/claims/nameidentifierpor uma versão concatenada do número CVR, display name e unique user ID - Selecione Action Replace claim
- Concatene os claims:
https://data.gov.dk/model/core/eid/professional/cvrhttp://schemas.xmlsoap.org/ws/2005/05/identity/claims/givennamehttp://schemas.xmlsoap.org/ws/2005/05/identity/claims/surnamehttp://schemas.xmlsoap.org/ws/2005/05/identity/claims/nameidentifier
- Defina Concatenate format string como
C=DK,O={0},CN={1} {2},Serial={3}
- 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.
- Vá ao separador Settings e a Claim mappings
- 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
- 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.

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>