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

Artikel
09/14/2023

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

Dela via