API de gestion dans SCEPmanClient

Utilisez Find-SCEPmanCertificate pour rechercher des certificats émis dans SCEPman et Revoke-SCEPmanCertificate pour révoquer un certificat lorsqu’il n’est plus approuvé ou n’est plus nécessaire.

Prérequis

Avant de pouvoir rechercher ou révoquer des certificats, assurez-vous que votre identité possède le Manage.All rôle.

Assurez-vous également d’avoir configuré les prérequis généraux pour l’utilisation de SCEPmanClient : https://app.gitbook.com/o/-LhPlvZ6dc8XcqY7tdZw/s/-LoGejQeUQcw7lqnQ3WX/~/edit/~/changes/863/certificate-management/api-certificates/scepmanclient#prerequisites

Si vous effectuez une mise à jour depuis une version antérieure de SCEPman, il se peut que vous n’ayez pas encore le rôle Manage.All. Exécutez Complete-SCEPmanInstallation à nouveau dans un cloud shell pour l’ajouter automatiquement à votre application SCEPman-api.

Rechercher des certificats

Utilisez Find-SCEPmanCertificate pour rechercher des certificats par leur numéro de série, leur sujet ou leur demandeur.

Si au moins un certificat est trouvé, un objet est renvoyé, ressemblant à la structure JSON suivante :

{
  "items": [
    {
    "serialNumber":  "507AEAC03CCEF83F106914418D9222E466A629C1",
    "subject":  "CN=device01.contoso.local",
    "sans":  null,
    "upn":  null,
    "issuanceDate":  "2026-05-28T10:57:22Z",
    "expirationDate":  "2028-05-28T10:57:22Z",
    "revocationDate":  null,
    "revocationReason":  null,
    "revokedBy":  null,
    "requester":  "[e-mail]",
    "source":  "CertificateMaster",
    "certificateType":  "Static"
    }
  ],
  "continuationToken": "..."
}

Exemple : rechercher un certificat unique par numéro de série

Find-SCEPmanCertificate -Url scepman.conitoso.com `
    -SearchText '5056BB9B823132CB26210A4C90A62FB3C25E38D0' `
    | Select-Object -ExpandProperty items

serialNumber     : 5056BB9B823132CB26210A4C90A62FB3C25E38D0
subject          : CN=[e-mail]
sans             : [e-mail]
upn              : [e-mail]
issuanceDate     : 2026-05-28T11:06:11Z
expirationDate   : 2028-05-28T11:06:11Z
revocationDate   :
revocationReason :
revokedBy        :
requester        : [e-mail]
source           : CertificateMaster
certificateType  : Static

Comprendre les résultats paginés

Si le jeu de résultats est volumineux, Find-SCEPmanCertificate peut renvoyer un jeton de continuation. Utilisez ce jeton pour demander la page suivante.

Exemple : première page avec jeton de continuation

$result = Find-SCEPmanCertificate -Url scepman.contoso.com -SearchText "CN=device"
$result

Exemple de sortie :

ContinuationToken : 1!48!ODY2OURBN0QtQzk0My00QjU3LUI5OEYtNzA5RjY5MDlCRDkw
Items             : {@{serialNumber=60B26DD32CF07F30D6760848A5233CBAE90DCDBC; subject=CN=device01.contoso.local},
                    @{serialNumber=50F1754E85238752527C3140ABD0CEF2C7DC9439; subject=CN=device02.contoso.local}}

Afficher les certificats renvoyés en détail

$result = Find-SCEPmanCertificate -Url scepman.contoso.com -SearchText "CN=device"
$result.Items

Exemple de sortie :

serialNumber                             subject
------------                             -------
60B26DD32CF07F30D6760848A5233CBAE90DCDBC CN=device01.contoso.local
50F1754E85238752527C3140ABD0CEF2C7DC9439 CN=device02.contoso.local

Demander la page suivante avec le jeton de continuation

$firstPage = Find-SCEPmanCertificate -Url scepman.contoso.com -SearchText "CN=device"
$nextPage = Find-SCEPmanCertificate -Url scepman.contoso.com -ContinuationToken $firstPage.ContinuationToken
$nextPage.Items

Exemple de sortie :

serialNumber                             subject
------------                             -------
5048D2541F7F401C42B7E943A7C82FB37A179F83 CN=device03.contoso.local
50BCCDA973AEEA55E00FAF4A9A088DFB7564F263 CN=device04.contoso.local

Révoquer un certificat

Utilisez Revoke-SCEPmanCertificate pour révoquer un certificat déjà émis par son numéro de série.

Revoke-SCEPmanCertificate -SerialNumber "480552CEBBE40FD5D4417532033728F353040000" -RevocationReason CessationOfOperation

Exemple : trouver un certificat et le révoquer

$result= Find-SCEPmanCertificate -Url scepman.contoso.com -SearchText "480552CEBBE40FD5D4417532033728F353040000"
$cert = $result.items

Revoke-SCEPmanCertificate -SerialNumber $cert.Items[0].serialNumber

Exemple de sortie :

Revoke-SCEPmanCertificate: Certificat 480552CEBBE40FD5D4417532033728F353040000 révoqué avec succès.