Prérequis à l'installation

Outre les conditions préalables énumérées ici pour l’installation d’Orchestrator, le serveur d'identité requiert les éléments suivants :

Certificats

Le serveur d'identité requiert 2 certificats valides :

• Un certificat pour le protocole HTTPS.

• Certificat utilisé pour signer les jetons générés par le serveur d’identité.

  Important :

  Pour des raisons de sécurité, le certificat utilisé par le serveur d’identité doit :

  • avoir une clé publique 2048 bits
  • dispose d'une clé privée accessible par l'utilisateur d'AppPool,
  • être dans sa période de validité (non expiré).

  L’emplacement du certificat se définit dans le fichier de configuration appsettings.Production.jsondu serveur d’identité, dans la section Signature des informations d’identification.
  Remarque : le certificat est utilisé pour signer les jetons d'accès OpenID qui sont utilisés pour l'identification de l'utilisateur via le navigateur et pour la communication de service à service entre Orchestrator et l'Identity Server. Cliquez ici pour plus de détails sur OpenID Connect.

Rotation des certificats

Vous pouvez utiliser la rotation des certificats pour éviter le risque d’expiration du certificat et, implicitement, une panne de l'Identity Server. Cette méthode implique de maintenir deux certificats et de procéder à leur rotation périodique. Notez toutefois que vous ne pouvez utiliser qu’une seule clé de signature à la fois.

Pour lancer le processus de rotation des certificats, procédez comme il suit :

1. Indiquez le Name, Location et NameType du certificat initial en utilisant le paramètre SigningCredential dans la section SigningCredential de appsettings.Production.json. Notez que la première clé de signature que vous enregistrez est la clé par défaut.
2. Spécifiez le Name du deuxième certificat, Location et NameType en utilisant le paramètre ValidationKeys dans la même section du fichier appsettings.Production.json. Assurez-vous de terminer cette étape avant la date de rotation.
3. À ce stade, le deuxième certificat est publié à l’aide du point de terminaison identity/.well-known/openid-configuration/jwks. Cela permet à chacun d'avoir suffisamment de temps pour mettre à jour son document de découverte mis en cache.
4. Au moment de la rotation, changez les certificats et redémarrez Identity Server. Le nouveau certificat peut maintenant être utilisé pour la signature alors que le certificat précédent continue d’être disponible à des fins de validation aussi longtemps que vous en aurez besoin.
5. Le certificat précédent peut être supprimé en toute sécurité de la configuration après 48 heures.

Dans l’exemple suivant, SigningCredential fait référence au certificat actuellement utilisé alors que ValidationKeys fait référence à la clé de validation nouvellement publiée.

"SigningCredentialSettings": {
      "StoreLocation": {
        "SigningCredential": {
            "Name": "2816a67bc34496ca0acabbe04eb149b88ade0684",
            "Location": "LocalMachine",
            "NameType" : "Thumbprint"
        },
        "ValidationKeys": [
            {
            "Name": "2cde6c443f0147c6258a6fe2203e71a997bfcd44",
            "Location": "LocalMachine",
            "NameType" : "Thumbprint"
            }
        ]
      }
    }

Important : Si vous utilisez AI Center, assurez-vous de le redéployer chaque fois que vous mettez à jour le certificat Identity Server.