API de administración en SCEPmanClient

Use Find-SCEPmanCertificate para buscar certificados emitidos en SCEPman y Revoke-SCEPmanCertificate para revocar un certificado cuando ya no es de confianza o ya no se necesita.

Requisitos

Antes de poder buscar o revocar certificados, asegúrese de que su identidad tenga el Manage.All rol.

Asegúrese también de haber configurado los requisitos previos generales para el uso de SCEPmanClient: https://app.gitbook.com/o/-LhPlvZ6dc8XcqY7tdZw/s/-LoGejQeUQcw7lqnQ3WX/~/edit/~/changes/863/certificate-management/api-certificates/scepmanclient#prerequisites

Si actualiza desde una versión anterior de SCEPman, es posible que todavía no tenga el rol Manage.All. Ejecute Complete-SCEPmanInstallation de nuevo en una consola en la nube para agregarlo automáticamente a su aplicación SCEPman-api.

Buscar certificados

Use Find-SCEPmanCertificate para buscar certificados por su número de serie, asunto o solicitante.

Si se encuentra al menos un certificado, se devuelve un objeto que se asemeja a la siguiente estructura JSON:

{
  "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": "..."
}

Ejemplo: Buscar un único certificado por número de serie

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

Comprender los resultados paginados

Si el conjunto de resultados es grande, Find-SCEPmanCertificate puede devolver un token de continuación. Use este token para solicitar la siguiente página.

Ejemplo: primera página con token de continuación

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

Salida de ejemplo:

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

Mostrar los certificados devueltos en detalle

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

Salida de ejemplo:

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

Solicite la siguiente página con el token de continuación

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

Salida de ejemplo:

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

Revocar un certificado

Use Revoke-SCEPmanCertificate para revocar un certificado previamente emitido por su número de serie.

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

Ejemplo: Buscar un certificado y revocarlo

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

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

Salida de ejemplo:

Revoke-SCEPmanCertificate: El certificado 480552CEBBE40FD5D4417532033728F353040000 se revocó correctamente.