Innehåll:
Eftersom det nya certifikatet kommer med en förnyad nyckel för signering av SAML-biljetten så kommer detta att påverkar alla tjänster (SP/RP) som använder IdP. SP/RP måste se till att ladda ner den nya nyckeln.
För SAML-SP betyder det att byta ut IdP-metadata.
För OIDC-RP måste förvaltaren kontrollera rutinen för att byta ut denna och vidta åtgärder ifall byte inte sker automatiskt.
Läs om strategin för bytet nedan om du ansvarar för en SP och längst ner på sidan för RP/OIDC-information!
Under februari 2024 går certifikaten som används för signering ut för IdP:n och byts därför ut.
De nya certifikaten kommer fortfarande att vara utfärdade av SITHS och vara av typerna enligt nedan:
- För PRODUKTION: SITHS e-id Function CA v1
- För TEST/QA: TEST SITHS e-id Function CA v1
Tidplan för certifikatsbyten
| Datum | Miljö | Aktivitet |
|---|---|---|
| TEST/QA | Publicering av nytt metadata för anslutna SP:s (se nedan) | |
| TEST/QA | Byte av IdP:ns certifikat och nyckel för signering av biljetter. | |
| PRODUKTION | Publicering av nytt metadata för anslutna SP:s (se nedan) | |
| PRODUKTION | Byte av IdP:ns certifikat och nyckel för signering av biljetter. |
IdP SAML Metadata
SP-INFO
INFORMATION TILL DE SOM ANSVARAR FÖR EN SERVICE PROVIDER (SP), ELLER RELAYING PARTY (RP), ANSLUTEN TILL INERAS IdP
Nyckeln som ligger i certifikatet i befintligt metadata som används av IdP:n för signering av SAML-biljetten/OIDC tokens kommer att förnyas i samband med certifikatsbytet. Därför förväntas alla Service Providers (SP:ar) anslutna till IdP:n att ladda ner och byta ut metadata för denna enligt informationen i detta dokument.
Processen
Steg 1 - Ineras IdP publicerar nytt metadata
För att alla SP:ar ska kunna få en sömlös övergång till det nya certifikatet kommer alla IdP:er under en period innan certifikatsbytet att publicera metadata med dubbla certifikat (KeyDescriptors) där endast ett av certifikaten används för signering av SAML-biljetten. SP:ar som har laddat ner och installerat detta metadata kommer då alltså vara förberedda att fungera med både det gamla och nya certifikatet och får då en sömlös övergång.
Steg 2 - SP börjar lita på nytt metadata
När detta har genomförts enligt tabellen Tidplan för certifikatsbyten ovan kan de SP:ar som stödjer dubbla KeyDescriptors i IdP:ns metadata installera det nya metadatat för att vara förberedda inför utbytet.
Alla SP:ar förväntas stödja dubbla KeyDescriptors i IdP:ns metadata och ha verifierat detta innan arbetet med certifikatsbytet påbörjas. Detta enligt SP-kraven i IdPns SAML-Profil
En SP som inte har stöd för dubbla KeyDescriptors i IdP:ns metadata kommer att vara tvungen att byta ut sitt metadata i samma stund som IdP:n byter certifikat enligt tabellen Tidplan för certifikatsbyten ovan för att kunna verifiera signeringen av SAML-biljetten efter bytet.
Steg 3 - IdP byter metadata
IdP byter metadata enligt tabellen Tidplan för certifikatsbyten
Steg 4 - IdP tar bort det gamla certifikatet från metadata
Efter certifikatsbytet återgår IdP:erna till att publicera metadata med endast det nya certifikatet och SP:ar kan "städa upp" genom att ladda ner nytt metadata igen innehållandes endast det nya certifikatet.
Ytterligare beskrivning av processen
Strategin visualiseras med bilden nedan:
Klicka på bilden för en större bild...
Tidsplan för byte av nyckel för signering av biljett
| Miljö | Publicering av nytt metadata med dubbla certifikat (steg 2) | Certifikatsbyte - metadata publiceras åter med endast ett certifikat |
|---|---|---|
|
| |
PRODUKTION: https://idp.inera.se |
|
|
Utförande på er SP
- Innan datum för Publicering av nytt metadata med dubbla certifikat: Säkerställ att er SP är förberedd för metadata med dubbla certifikat/KeyDescriptors.
- Observera att om detta stöd inte finns eller införs måste SP:n byta metadata i samma stund som IdP:n byter certifikatet.
- En SP utan detta stöd kan dock fortsätta att använda sitt gamla IdP-metadata tills dess att IdP:n byter certifikatet.
- Mellan datum för Publicering av nytt metadata med dubbla certifikat och Certifikatsbyte: Ladda ner IdP:ns nya metadata och installera detta i er SP för att klara av både det gamla och nya certifikatet och få en sömlös övergång.
- Nedladdningslänkar för aktuell IdP hittas i listan över Adresser för nerladdning av metadata nedan.
- Efter datum för Certifikatsbyte: Ladda ner IdP:ns nya metadata och installera detta i er SP för att endast ha det nya certifikatet i IdP:ns metadata (uppstädning).
Adresser för nerladdning av metadata
- Test: https://idp.ineratest.org/saml
- QA: https://idp.ineraqa.org/saml
- Produktion: https://idp.inera.se/saml
OIDC RP-information
I OIDC-världen finns ingen utväxling av metadata som för SAML utan här sker ofta uppdatering av IdP:ns nycklar, som används för signering, automatiskt i bakgrunden. Även här kommer dubbla nycklar att publiceras enligt tidsplanen ovan så att RP:n kan få en sömlös övergång till den nya nyckeln.
Adresser för nerladdning av signeringsnycklar (OIDC)
- Test: https://idp.ineratest.org/oidc/jwks.json
- QA: https://idp.ineraqa.org/oidc/jwks.json
- Produktion: https://idp.inera.se/oidc/jwks.json
För frågor kontakta Ineras Kundservice