> For the complete documentation index, see [llms.txt](https://docs.scepman.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.scepman.com/es/administracion-de-certificados/api-rest-de-administracion/api-de-administracion-en-scepmanclient.md). # API de administración en SCEPmanClient Uso `Use Find-SCEPmanCertificate` para buscar certificados emitidos en SCEPman y `Revoke-SCEPmanCertificate` para revocar un certificado cuando ya no sea de confianza o ya no sea necesario. ### 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](/es/administracion-de-certificados/api-certificates/scepmanclient.md#prerequisites) {% hint style="info" %} Si actualiza desde una versión anterior de SCEPman, es posible que aún no tenga el rol Manage.All. Ejecute `Complete-SCEPmanInstallation` de nuevo en un cloud shell para agregarlo automáticamente a su aplicación SCEPman-api. {% endhint %} ### Buscar certificados Uso `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 con una estructura JSON similar a la siguiente: ```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": "pkiAdmin@contoso.com", "source": "CertificateMaster", "certificateType": "Static" } ], "continuationToken": "..." } ``` #### Ejemplo: encontrar un único certificado por número de serie ```powershell Find-SCEPmanCertificate -Url scepman.conitoso.com ` -SearchText '5056BB9B823132CB26210A4C90A62FB3C25E38D0' ` | Select-Object -ExpandProperty items serialNumber : 5056BB9B823132CB26210A4C90A62FB3C25E38D0 subject : CN=clara.oswald@contoso.com sans : clara.oswald@contoso.com upn : clara.oswald@contoso.com issuanceDate : 2026-05-28T11:06:11Z expirationDate : 2028-05-28T11:06:11Z revocationDate : revocationReason : revokedBy : requester : pkiAdmin@contoso.com source : CertificateMaster certificateType : Static ``` ### Entender resultados paginados Si el conjunto de resultados es grande, `Use 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 ```powershell $result = Find-SCEPmanCertificate -Url scepman.contoso.com -SearchText "CN=device" $result ``` Salida de ejemplo: ```powershell 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 ```powershell $result = Find-SCEPmanCertificate -Url scepman.contoso.com -SearchText "CN=device" $result.Items ``` Salida de ejemplo: ```powershell serialNumber subject ------------ ------- 60B26DD32CF07F30D6760848A5233CBAE90DCDBC CN=device01.contoso.local 50F1754E85238752527C3140ABD0CEF2C7DC9439 CN=device02.contoso.local ``` #### Solicite la siguiente página con el token de continuación ```powershell $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: ```powershell serialNumber subject ------------ ------- 5048D2541F7F401C42B7E943A7C82FB37A179F83 CN=device03.contoso.local 50BCCDA973AEEA55E00FAF4A9A088DFB7564F263 CN=device04.contoso.local ``` ### Revocar un certificado Uso `Revoke-SCEPmanCertificate` para revocar un certificado por su número de serie que fue emitido previamente. ```powershell Revoke-SCEPmanCertificate -SerialNumber "480552CEBBE40FD5D4417532033728F353040000" -RevocationReason CessationOfOperation ``` #### Ejemplo: buscar un certificado y revocarlo ```powershell $result= Find-SCEPmanCertificate -Url scepman.contoso.com -SearchText "480552CEBBE40FD5D4417532033728F353040000" $cert = $result.items Revoke-SCEPmanCertificate -SerialNumber $cert.Items[0].serialNumber ``` Salida de ejemplo: ```powershell Revoke-SCEPmanCertificate: Certificado 480552CEBBE40FD5D4417532033728F353040000 revocado correctamente. ``` --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.scepman.com/es/administracion-de-certificados/api-rest-de-administracion/api-de-administracion-en-scepmanclient.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.