Uzyskiwanie opcji generowania żądań certyfikatów

Pobiera parametry generowania żądania certyfikatu po stronie klienta.

Uwaga

Adresy URL w tym artykule są względne względem nazwy hosta wybranej podczas wdrażania interfejsu API, takiej jak https://api.contoso.com .

Żądanie

Metoda Adres URL żądania
GET /CertificateManagement/api/v1.0/requests/{requestid}/certificaterequestgenerationoptions

Parametry URL

Parametr Opis
Requestid Wymagane. Identyfikator GUID żądania MIM CM, dla którego mają zostać pobrane parametry generowania żądania certyfikatu.

Nagłówki żądań

Aby uzyskać informacje o typowych nagłówkach żądań, zobacz Nagłówki żądań i odpowiedzi HTTP w sekcji Szczegóły usługi interfejsu API REST usługi CM.

Treść żądania

Brak.

Reakcja

W tej sekcji opisano odpowiedź.

Kody odpowiedzi

Kod Opis
200 OK
204 Brak zawartości
403 Forbidden
500 Błąd wewnętrzny

Nagłówki odpowiedzi

Aby uzyskać informacje o typowych nagłówkach żądań, zobacz Nagłówki żądań i odpowiedzi HTTP w sekcji Szczegóły usługi interfejsu API REST usługi CM.

Treść odpowiedzi

W przypadku powodzenia zwraca listę obiektów CertificateRequestGenerationOptions. Każdy obiekt CertificateRequestGenerationOptions odpowiada pojedynczemu żądaniu certyfikatu, które musi wygenerować klient. Każdy obiekt ma następujące właściwości:

Właściwość Opis
Można eksportować Wartość określająca, czy można wyeksportować klucz prywatny utworzony dla żądania.
FriendlyName Nazwa wyświetlana zarejestrowanego certyfikatu.
HashAlgorithmName Algorytm wyznaczania wartości skrótu używany podczas tworzenia podpisu żądania certyfikatu.
KeyAlgorithmName Algorytm klucza publicznego.
KeyProtectionLevel Poziom silnej ochrony klucza.
Keysize Rozmiar klucza prywatnego do wygenerowania w bitach.
KeyStorageProviderNames Lista akceptowalnych dostawców magazynu kluczy (KSP), których można użyć do wygenerowania klucza prywatnego. Gdy nie można użyć pierwszego KSP do wygenerowania żądania certyfikatu, można użyć dowolnego z określonych PSP, dopóki jeden zakończy się pomyślnie.
KeyUsages Operacja, która może zostać wykonana przez klucz prywatny utworzony dla tego żądania certyfikatu. Wartość domyślna to Podpisywanie.
Temat Nazwa podmiotu.

Uwaga

Więcej informacji o tych właściwościach można znaleźć w Windows. Opis klasy Security.Cryptography.Certificates.CertificateRequestProperties. Należy pamiętać, że między tą klasą a obiektami CertificateRequestGenerationOptions nie istnieje związek "jeden do jednego".

Przykład

Ta sekcja zawiera przykład, aby uzyskać opcje generowania żądania certyfikatu.

Przykład: Żądanie

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

Przykład: Odpowiedź

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