Hämta alternativ för generering av certifikatbegäran

  • Artikel

Hämtar parametrar för generering av certifikatbegäran på klientsidan.

Anteckning

URL:erna i den här artikeln är relativa till det värdnamn som väljs under API-distributionen, till exempel https://api.contoso.com.

Förfrågan

Metod Begärans-URL
GET /CertificateManagement/api/v1.0/requests/{requestid}/certificaterequestgenerationoptions

URL-parametrar

Parameter Beskrivning
Id Krävs. GUID-identifieraren för MIM CM-begäran som genereringsparametrarna för certifikatbegäran ska hämtas för.

Begärandehuvuden

Vanliga begärandehuvuden finns i HTTP-begärande- och svarshuvuden i CM REST API-tjänstinformation.

Begärandetext

Inga.

Svarsåtgärder

I det här avsnittet beskrivs svaret.

Svarskoder

Kod Description
200 OK
204 Inget innehåll
403 Förbjudet
500 Internt fel

Svarshuvuden

Vanliga begärandehuvuden finns i HTTP-begärande- och svarshuvuden i CM REST API-tjänstinformation.

Själva svaret

Vid lyckat resultat returneras en lista över CertificateRequestGenerationOptions-objekt. Varje CertificateRequestGenerationOptions-objekt motsvarar en enda certifikatbegäran som klienten måste generera. Varje objekt har följande egenskaper:

Egenskap Beskrivning
Exportera Ett värde som anger om den privata nyckeln som skapats för begäran kan exporteras.
FriendlyName Visningsnamnet för det registrerade certifikatet.
HashAlgorithmName Hash-algoritmen som används när du skapar signaturen för certifikatbegäran.
KeyAlgorithmName Algoritmen för offentlig nyckel.
KeyProtectionLevel Nivån på starkt nyckelskydd.
Keysize Storleken, i bitar, på den privata nyckel som ska genereras.
KeyStorageProviderNames En lista över godtagbara nyckellagringsproviders (KSP:er) som kan användas för att generera den privata nyckeln. När den första KSP:n inte kan användas för att generera certifikatbegäran kan någon av de angivna KSP:erna användas tills en lyckas.
KeyUsages Åtgärden som kan utföras av den privata nyckeln som skapats för den här certifikatbegäran. Standardvärdet är Signering.
Ämne Ämnesnamnet.

Anteckning

Mer information om dessa egenskaper finns i klassbeskrivningen Windows.Security.Cryptography.Certificates.CertificateRequestProperties . Tänk på att det inte finns någon en-till-en-korrespondens mellan den här klassen och CertificateRequestGenerationOptions-objekt.

Exempel

Det här avsnittet innehåller ett exempel för att hämta genereringsalternativen för en certifikatbegäran.

Exempel: Begäran

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

Exempel: Svar

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
    }
]