Hämta Generation alternativen för certifikatförfråganGet Certificate Request Generation Options

Hämtar parametrar för klientsidan Certifikatgenereringen begäran.Gets parameters for client-side certificate request generation.

Obs: URL: er som visas i det här avsnittet är i förhållande till värdnamnet valt under distributionen av API, till exempel: https://api.contoso.com.Note: URLs shown in this topic are relative to the hostname chosen during API deployment; for example: https://api.contoso.com.

BegäranRequest

MetodMethod URL-begäranRequest URL
GETGET /CertificateManagement/API/v1.0/Requests/{RequestId}/certificaterequestgenerationoptions/CertificateManagement/api/v1.0/requests/{requestid}/certificaterequestgenerationoptions

URL-parametrarURL Parameters

ParameterParameter BeskrivningDescription
begärande-IDrequestid Obligatoriskt.Required. GUID-identifierare för MIM CM-begäran för certifikatet generation parametrarna som ska hämtas.The GUID identifier of the MIM CM request for which the certificate request generation parameters are to be retrieved.

Huvuden för begäranRequest Headers

Vanliga begärandehuvuden finns HTTP-begäran och svarshuvuden i CM REST API-tjänsteinformation.For common request headers, see HTTP Request and Response Headers in CM REST API Service Details.

BegärandetextenRequest Body

Ingen.none.

SvarResponse

SvarskoderResponse Codes

KodCode BeskrivningDescription
200200 OKOK
204204 Inget innehållNo Content
403403 Tillåts inteForbidden
500500 Internt felInternal Error

SvarsrubrikerResponse Headers

Vanliga svarshuvuden finns HTTP-begäran och svarshuvuden i CM REST API-tjänsteinformation.For common response headers, see HTTP Request and Response Headers in CM REST API Service Details.

SvarstextenResponse Body

Returnerar listan med objekt som CertificateRequestGenerationOptions på åtgärden lyckades.On success, returns list of CertificateRequestGenerationOptions objects. Varje CertificateRequestGenerationOptions objekt motsvarar en enda certifikatbegäran att klienten har att generera och har följande egenskaper:Each CertificateRequestGenerationOptions object corresponds to a single certificate request that the client has to generate and has the following properties:

EgenskapProperty BeskrivningDescription
ExporteraExportable Ett värde som anger om den privata nyckeln som skapats för begäran kan exporteras.A value that specifies whether the private key created for the request can be exported.
FriendlyNameFriendlyName Visningsnamnet för det registrerade certifikatet.The display name of the enrolled certificate.
HashAlgorithmNameHashAlgorithmName Hash-algoritmen som används när du skapar certifikatets begäran signatur.The hash algorithm used when creating the certificate request signature.
KeyAlgorithmNameKeyAlgorithmName Nyckelalgoritmen.The public key algorithm.
KeyProtectionLevelKeyProtectionLevel Andelen starkt nyckelskydd.The level of strong key protection.
KeySizeKeySize Storlek i bitar av den privata nyckeln som ska genereras.The size, in bits, of the private key to be generated.
KeyStorageProviderNamesKeyStorageProviderNames En lista över godkända nyckellagring (KSP) som kan användas för att generera den privata nyckeln.A list of acceptable key storage providers (KSPs) that can be used to generate the private key. I fallet får att första KSP inte kan användas för att generera begäran cert någon av de angivna KSP: er inte användas tills ett lyckas.In the case that the first KSP cannot be used to generate the cert request, any of the specified KSPs may be used until one succeeds.
KeyUsagesKeyUsages Åtgärden kan utföras av den privata nyckeln som skapats för denna begäran.The operation that can be performed by the private key created for this certificate request. Standardvärdet är signering.The default value is Signing.
ÄrendeSubject Ämnesnamnet.The subject name.

Obs: Mer information om dessa egenskaper finns i den Windows.Security.Cryptography.Certificates.CertificateRequestProperties klassen beskrivning, men tänk på att det inte är en överensstämmelsen mellan den här klassen och CertificateRequestGenerationOptions objekt.Note: More information about these properties is available in the Windows.Security.Cryptography.Certificates.CertificateRequestProperties class description, but be aware that there is not a one-to-one correspondence between this class and CertificateRequestGenerationOptions objects.

ExempelExample

BegäranRequest

GET /certificatemanagement/api/v1.0/requests/a9b4b42c-cc50-4c9b-89d1-bbc0bcd5a099/certificaterequestgenerationoptions HTTP/1.1

SvarResponse

HTTP/1.1 200 OK

[
    {
        "Subject":"",
        "KeyAlgorithmName":"RSA",
        "KeySize":2048,
        "FriendlyName":"",
        "HashAlgorithmName":"SHA1",
        "KeyStorageProviderNames":[
            "Contoso Smart Card Key Storage Provider"
        ],
        "Exportable":0,
        "KeyProtectionLevel":0,
        "KeyUsages":3
    }
]