Delen via

CertificateClient class

  • Referentie
Pakket:
@azure/keyvault-certificates

De client voor interactie met de functionaliteit van KeyVault-certificaten

Constructors

CertificateClient(string, TokenCredential, CertificateClientOptions)

Hiermee maakt u een exemplaar van CertificateClient.

Eigenschappen

vaultUrl

De basis-URL naar de kluis

Methoden

backupCertificate(string, BackupCertificateOptions)

Hiermee wordt aangevraagd dat een back-up van het opgegeven certificaat naar de client wordt gedownload. Alle versies van het certificaat worden gedownload. Voor deze bewerking is de machtiging certificaten/back-up vereist. Gebruiksvoorbeeld:

const client = new CertificateClient(url, credentials);
await client.beginCreateCertificate("MyCertificate", {
  issuerName: "Self",
  subject: "cn=MyCert"
});
const backup = await client.backupCertificate("MyCertificate");

Hiermee wordt een back-up van een certificaat gegenereerd
beginCreateCertificate(string, CertificatePolicy, BeginCreateCertificateOptions)

Hiermee maakt u een nieuw certificaat. Als dit de eerste versie is, wordt de certificaatresource gemaakt. Deze functie retourneert een poller voor langdurige bewerkingen waarmee u voor onbepaalde tijd kunt wachten totdat het certificaat volledig is hersteld. Opmerking: Als u verzendt Self als van issuerName het beleid van het certificaat, wordt een zelfondertekend certificaat gemaakt.

Voor deze bewerking is de machtiging certificaten/maken vereist.

Gebruiksvoorbeeld:

const client = new CertificateClient(url, credentials);
const certificatePolicy = {
  issuerName: "Self",
  subject: "cn=MyCert"
};
const createPoller = await client.beginCreateCertificate("MyCertificate", certificatePolicy);

// The pending certificate can be obtained by calling the following method:
const pendingCertificate = createPoller.getResult();

// Serializing the poller
const serialized = createPoller.toString();

// A new poller can be created with:
// const newPoller = await client.beginCreateCertificate("MyCertificate", certificatePolicy, { resumeFrom: serialized });

// Waiting until it's done
const certificate = await createPoller.pollUntilDone();
console.log(certificate);

Hiermee maakt u een certificaat
beginDeleteCertificate(string, BeginDeleteCertificateOptions)

De delete-bewerking is van toepassing op elk certificaat dat is opgeslagen in Azure Key Vault. DELETE kan niet worden toegepast op een afzonderlijke versie van een certificaat. Deze functie retourneert een poller voor langdurige bewerkingen waarmee u voor onbepaalde tijd kunt wachten totdat het certificaat volledig is hersteld. Voor deze bewerking is de machtiging certificaten/verwijderen vereist.

Gebruiksvoorbeeld:

const client = new CertificateClient(url, credentials);
const createPoller = await client.beginCreateCertificate("MyCertificate", {
  issuerName: "Self",
  subject: "cn=MyCert"
});
await createPoller.pollUntilDone();

const deletePoller = await client.beginDeleteCertificate("MyCertificate");

// Serializing the poller
const serialized = deletePoller.toString();

// A new poller can be created with:
// const newPoller = await client.beginDeleteCertificate("MyCertificate", { resumeFrom: serialized });

// Waiting until it's done
const deletedCertificate = await deletePoller.pollUntilDone();
console.log(deletedCertificate);

Hiermee verwijdert u een certificaat uit een opgegeven sleutelkluis.
beginRecoverDeletedCertificate(string, BeginRecoverDeletedCertificateOptions)

Herstelt het verwijderde certificaat in de opgegeven kluis. Deze bewerking kan alleen worden uitgevoerd op een kluis waarvoor voorlopig verwijderen is ingeschakeld. Deze bewerking Deze functie retourneert een long running operation poller waarmee u voor onbepaalde tijd kunt wachten totdat het certificaat volledig is hersteld. Voor deze bewerking is de machtiging certificaten/herstellen vereist.

Gebruiksvoorbeeld:

const client = new CertificateClient(url, credentials);

const deletePoller = await client.beginDeleteCertificate("MyCertificate");
await deletePoller.pollUntilDone();

const recoverPoller = await client.beginRecoverDeletedCertificate("MyCertificate");

// Serializing the poller
const serialized = deletePoller.toString();

// A new poller can be created with:
// const newPoller = await client.beginRecoverDeletedCertificate("MyCertificate", { resumeFrom: serialized });

// Waiting until it's done
const certificate = await recoverPoller.pollUntilDone();
console.log(certificate);

Een verwijderd certificaat herstellen
createIssuer(string, string, CreateIssuerOptions)

Met de bewerking createIssuer wordt de opgegeven certificaatverlener toegevoegd of bijgewerkt. Voor deze bewerking is de machtiging certificaten/setissuers vereist. Gebruiksvoorbeeld:

const client = new CertificateClient(url, credentials);
await client.createIssuer("IssuerName", "Test");

Hiermee stelt u de opgegeven certificaatverlener in.
deleteCertificateOperation(string, DeleteCertificateOperationOptions)

Hiermee verwijdert u de aanmaakbewerking voor een opgegeven certificaat dat wordt gemaakt. Het certificaat wordt niet meer gemaakt. Voor deze bewerking is de machtiging certificaten/bijwerken vereist. Gebruiksvoorbeeld:

const client = new CertificateClient(url, credentials);
await client.beginCreateCertificate("MyCertificate", {
  issuerName: "Self",
  subject: "cn=MyCert"
});
await client.deleteCertificateOperation("MyCertificate");
await client.getCertificateOperation("MyCertificate"); // Throws error: Pending certificate not found: "MyCertificate"

De bewerking van een certificaat verwijderen
deleteContacts(DeleteContactsOptions)

Hiermee verwijdert u alle certificaatcontactpersonen. Voor deze bewerking is de machtiging certificaten/managecontacts vereist. Gebruiksvoorbeeld:

let client = new CertificateClient(url, credentials);
await client.setContacts([{
  email: "b@b.com",
  name: "b",
  phone: "222222222222"
}]);
await client.deleteContacts();

Hiermee verwijdert u alle certificaatcontactpersonen
deleteIssuer(string, DeleteIssuerOptions)

Met de bewerking deleteIssuer wordt de opgegeven certificaatverlener definitief uit de kluis verwijderd. Voor deze bewerking is de machtiging certificates/manageissuers/deleteissuers vereist. Gebruiksvoorbeeld:

const client = new CertificateClient(url, credentials);
await client.createIssuer("IssuerName", "Provider");
await client.deleteIssuer("IssuerName");

Hiermee verwijdert u de opgegeven certificaatverlener.
getCertificate(string, GetCertificateOptions)

Hiermee haalt u de meest recente informatie op die beschikbaar is van een specifiek certificaat, waaronder het beleid van het certificaat. Voor deze bewerking zijn de certificaten/machtigingen voor ophalen vereist. Gebruiksvoorbeeld:

const client = new CertificateClient(url, credentials);
const poller = await client.beginCreateCertificate("MyCertificate", {
  issuerName: "Self",
  subject: "cn=MyCert"
});
await poller.pollUntilDone();
const certificate = await client.getCertificate("MyCertificate");
console.log(certificate);

Haalt een certificaat op uit de naam van het certificaat (inclusief het certificaatbeleid)
getCertificateOperation(string, GetCertificateOperationOptions)

Hiermee haalt u de aanmaakbewerking op die is gekoppeld aan een opgegeven certificaat. Voor deze bewerking zijn de certificaten/machtigingen voor ophalen vereist. Deze functie retourneert een poller voor langdurige bewerkingen waarmee u voor onbepaalde tijd kunt wachten totdat het certificaat volledig is hersteld. Gebruiksvoorbeeld:

const client = new CertificateClient(url, credentials);
const createPoller = await client.beginCreateCertificate("MyCertificate", {
  issuerName: "Self",
  subject: "cn=MyCert"
});

const poller = await client.getCertificateOperation("MyCertificate");
const pendingCertificate = poller.getResult();

const certificateOperation = poller.getOperationState().certificateOperation;
console.log(certificateOperation);

Hiermee haalt u de pollerbewerking van een certificaat op
getCertificatePolicy(string, GetCertificatePolicyOptions)

De bewerking getCertificatePolicy retourneert de opgegeven certificaatbeleidsresources in de opgegeven sleutelkluis. Voor deze bewerking zijn de certificaten/machtigingen voor ophalen vereist. Gebruiksvoorbeeld:

const client = new CertificateClient(url, credentials);
await client.beginCreateCertificate("MyCertificate", {
  issuerName: "Self",
  subject: "cn=MyCert"
});
const policy = await client.getCertificatePolicy("MyCertificate");
console.log(policy);

Hiermee haalt u het beleid van een certificaat op
getCertificateVersion(string, string, GetCertificateVersionOptions)

Hiermee haalt u informatie op over een specifiek certificaat voor een specifieke versie. Het beleid van het certificaat wordt niet geretourneerd. Voor deze bewerking zijn de certificaten/machtigingen voor ophalen vereist. Gebruiksvoorbeeld:

const client = new CertificateClient(url, credentials);
const poller = await client.beginCreateCertificate("MyCertificate", {
  issuerName: "Self",
  subject: "cn=MyCert"
});
await poller.pollUntilDone();
const certificateWithPolicy = await client.getCertificate("MyCertificate");
const certificate = await client.getCertificateVersion("MyCertificate", certificateWithPolicy.properties.version!);
console.log(certificate);

Haalt een certificaat op van de naam van het certificaat en een opgegeven versie
getContacts(GetContactsOptions)

Retourneert de set resources voor certificaatcontactpersonen in de opgegeven sleutelkluis. Voor deze bewerking is de machtiging certificaten/managecontacts vereist. Gebruiksvoorbeeld:

let client = new CertificateClient(url, credentials);
await client.setContacts([{
  email: "b@b.com",
  name: "b",
  phone: "222222222222"
}]);
const contacts = await client.getContacts();
console.log(contacts);

Hiermee stelt u de certificaatcontactpersonen in.
getDeletedCertificate(string, GetDeletedCertificateOptions)

haalt de verwijderde certificaatgegevens plus de bijbehorende kenmerken op, zoals retentie-interval, geplande permanente verwijdering en het huidige herstelniveau voor verwijdering. Voor deze bewerking zijn de certificaten/machtigingen voor ophalen vereist. Gebruiksvoorbeeld:

const client = new CertificateClient(url, credentials);
const deletedCertificate = await client.getDeletedCertificate("MyDeletedCertificate");
console.log("Deleted certificate:", deletedCertificate);

Hiermee haalt u een verwijderd certificaat op
getIssuer(string, GetIssuerOptions)

De bewerking getIssuer retourneert de opgegeven certificaatverlenerresources in de opgegeven sleutelkluis. Voor deze bewerking is de machtiging certificates/manageissuers/getissuers vereist. Gebruiksvoorbeeld:

const client = new CertificateClient(url, credentials);
await client.createIssuer("IssuerName", "Test");
const certificateIssuer = await client.getIssuer("IssuerName");
console.log(certificateIssuer);

Haalt de door hem opgegeven certificaatverlener op.
importCertificate(string, Uint8Array, ImportCertificateOptions)

Hiermee importeert u een bestaand geldig certificaat met een persoonlijke sleutel in Azure Key Vault. Het certificaat dat moet worden geïmporteerd, kan de PFX- of PEM-indeling hebben. Als het certificaat de PEM-indeling heeft, moet het PEM-bestand de sleutel en x509-certificaten bevatten. Voor deze bewerking is de machtiging certificaten/importeren vereist. Gebruiksvoorbeeld:

const client = new CertificateClient(url, credentials);
// See: @azure/keyvault-secrets
const certificateSecret = await secretClient.getSecret("MyCertificate");
const base64EncodedCertificate = certificateSecret.value!;
let buffer: Uint8Array;

if (isNode) {
  buffer = Buffer.from(base64EncodedCertificate, "base64");
} else {
  buffer = Uint8Array.from(atob(base64EncodedCertificate), (c) => c.charCodeAt(0));
}

await client.importCertificate("MyCertificate", buffer);

Importeert een certificaat uit de geheime waarde van een certificaat
listDeletedCertificates(ListDeletedCertificatesOptions)

Haalt de certificaten op in de huidige kluis die de status Verwijderd hebben en gereed zijn voor herstel of opschoning. Deze bewerking omvat gegevens die specifiek zijn voor verwijdering. Voor deze bewerking is de machtiging certificaten/get/list vereist. Deze bewerking kan alleen worden ingeschakeld voor kluizen waarvoor voorlopig verwijderen is ingeschakeld. Gebruiksvoorbeeld:

const client = new CertificateClient(url, credentials);
for await (const deletedCertificate of client.listDeletedCertificates()) {
  console.log(deletedCertificate);
}
for await (const page of client.listDeletedCertificates().byPage()) {
  for (const deletedCertificate of page) {
    console.log(deletedCertificate);
  }
}

Lijst met verwijderde certificaten
listPropertiesOfCertificates(ListPropertiesOfCertificatesOptions)

Hiermee wordt de nieuwste versie van alle certificaten in de kluis herhaald. De volledige certificaat-id en -kenmerken worden opgegeven in het antwoord. Er worden geen waarden geretourneerd voor de certificaten. Voor deze bewerking is de machtiging certificaten/lijst vereist. Gebruiksvoorbeeld:

const client = new CertificateClient(url, credentials);
// All in one call
for await (const certificateProperties of client.listPropertiesOfCertificates()) {
  console.log(certificateProperties);
}
// By pages
for await (const page of client.listPropertiesOfCertificates().byPage()) {
  for (const certificateProperties of page) {
    console.log(certificateProperties);
  }
}

Alle versies van het opgegeven certificaat weergeven.
listPropertiesOfCertificateVersions(string, ListPropertiesOfCertificateVersionsOptions)

Retourneert de versies van een certificaat in de opgegeven sleutelkluis. Voor deze bewerking is de machtiging certificaten/lijst vereist. Gebruiksvoorbeeld:

const client = new CertificateClient(url, credentials);
for await (const certificateProperties of client.listPropertiesOfCertificateVersions("MyCertificate")) {
  console.log(certificateProperties.version!);
}

De versies van een certificaat weergeven.
listPropertiesOfIssuers(ListPropertiesOfIssuersOptions)

Retourneert de set resources voor certificaatverleners in de opgegeven sleutelkluis. Voor deze bewerking is de machtiging certificates/manageissuers/getissuers vereist. Gebruiksvoorbeeld:

const client = new CertificateClient(url, credentials);
await client.createIssuer("IssuerName", "Test");
// All in one call
for await (const issuerProperties of client.listPropertiesOfIssuers()) {
  console.log(issuerProperties);
}
// By pages
for await (const page of client.listPropertiesOfIssuers().byPage()) {
  for (const issuerProperties of page) {
    console.log(issuerProperties);
  }
}

De certificaatverleners weergeven.
mergeCertificate(string, Uint8Array[], MergeCertificateOptions)

Hiermee wordt een certificaat of certificaatketen samengevoegd met een sleutelpaar dat momenteel beschikbaar is in de service. Voor deze bewerking is de machtiging certificaten/maken vereist. Gebruiksvoorbeeld:

const client = new CertificateClient(url, credentials);
await client.beginCreateCertificate("MyCertificate", {
  issuerName: "Unknown",
  subject: "cn=MyCert"
});
const poller = await client.getCertificateOperation("MyCertificate");
const { csr } = poller.getOperationState().certificateOperation!;
const base64Csr = Buffer.from(csr!).toString("base64");
const wrappedCsr = ["-----BEGIN CERTIFICATE REQUEST-----", base64Csr, "-----END CERTIFICATE REQUEST-----"].join("\n");

const fs = require("fs");
fs.writeFileSync("test.csr", wrappedCsr);

// Certificate available locally made using:
//   openssl genrsa -out ca.key 2048
//   openssl req -new -x509 -key ca.key -out ca.crt
// You can read more about how to create a fake certificate authority here: https://gist.github.com/Soarez/9688998

const childProcess = require("child_process");
childProcess.execSync("openssl x509 -req -in test.csr -CA ca.crt -CAkey ca.key -CAcreateserial -out test.crt");
const base64Crt = fs.readFileSync("test.crt").toString().split("\n").slice(1, -1).join("");

await client.mergeCertificate("MyCertificate", [Buffer.from(base64Crt)]);

Hiermee wordt een ondertekende certificaataanvraag samengevoegd in een certificaat in behandeling
purgeDeletedCertificate(string, PurgeDeletedCertificateOptions)

Voert een onomkeerbare verwijdering van het opgegeven certificaat uit, zonder mogelijkheid tot herstel. De bewerking is niet beschikbaar als het herstelniveau niet 'Opschoonbaar' opgeeft. Voor deze bewerking is de machtiging certificaat/opschonen vereist. Gebruiksvoorbeeld:

const client = new CertificateClient(url, credentials);
const deletePoller = await client.beginDeleteCertificate("MyCertificate");
await deletePoller.pollUntilDone();
// Deleting a certificate takes time, make sure to wait before purging it
client.purgeDeletedCertificate("MyCertificate");

Hiermee haalt u een verwijderd certificaat op
restoreCertificateBackup(Uint8Array, RestoreCertificateBackupOptions)

Hiermee herstelt u een back-up van een certificaat en alle bijbehorende versies naar een kluis. Voor deze bewerking is de machtiging certificaten/herstellen vereist. Gebruiksvoorbeeld:

const client = new CertificateClient(url, credentials);
await client.beginCreateCertificate("MyCertificate", {
  issuerName: "Self",
  subject: "cn=MyCert"
});
const backup = await client.backupCertificate("MyCertificate");
const poller = await client.beginDeleteCertificate("MyCertificate");
await poller.pollUntilDone();
// Some time is required before we're able to restore the certificate
await client.restoreCertificateBackup(backup!);

Een certificaat terugzetten vanuit een back-up
setContacts(CertificateContact[], SetContactsOptions)

Hiermee stelt u de certificaatcontactpersonen voor de sleutelkluis in. Voor deze bewerking is de machtiging certificaten/managecontacts vereist. Gebruiksvoorbeeld:

let client = new CertificateClient(url, credentials);
await client.setContacts([{
  email: "b@b.com",
  name: "b",
  phone: "222222222222"
}]);

Hiermee stelt u de certificaatcontactpersonen in.
updateCertificatePolicy(string, CertificatePolicy, UpdateCertificatePolicyOptions)

Updates het certificaatbeleid voor het opgegeven certificaat. Voor deze bewerking is de machtiging certificaten/bijwerken vereist. Hiermee haalt u het beleid van een certificaat op
updateCertificateProperties(string, string, UpdateCertificateOptions)

Past de opgegeven update toe op het opgegeven certificaat; de enige elementen die zijn bijgewerkt, zijn de kenmerken van het certificaat. Voor deze bewerking is de machtiging certificaten/bijwerken vereist. Gebruiksvoorbeeld:

const client = new CertificateClient(url, credentials);
await client.beginCreateCertificate("MyCertificate", {
  issuerName: "Self",
  subject: "cn=MyCert"
});
await client.updateCertificateProperties("MyCertificate", "", {
  tags: {
    customTag: "value"
  }
});

een certificaat Updates
updateIssuer(string, UpdateIssuerOptions)

De updateIssuer-bewerking voert een update uit op de opgegeven certificaatverlenerentiteit. Voor deze bewerking is de machtiging certificaten/setissuers vereist. Gebruiksvoorbeeld:

const client = new CertificateClient(url, credentials);
await client.createIssuer("IssuerName", "Test");
await client.updateIssuer("IssuerName", {
  provider: "Provider2"
});

Updates de opgegeven certificaatverlener.

Constructordetails

CertificateClient(string, TokenCredential, CertificateClientOptions)

Hiermee maakt u een exemplaar van CertificateClient.

new CertificateClient(vaultUrl: string, credential: TokenCredential, pipelineOptions?: CertificateClientOptions)

Parameters

vaultUrl

string

de basis-URL naar de kluis.

credential

TokenCredential

Een object dat de TokenCredential interface implementeert die wordt gebruikt om aanvragen voor de service te verifiëren. Gebruik het pakket @azure/identity om een referentie te maken die aan uw behoeften voldoet.

pipelineOptions
CertificateClientOptions

Pijplijnopties die worden gebruikt voor het configureren van Key Vault API-aanvragen. Laat deze parameter weg om de standaardpijplijnconfiguratie te gebruiken.

Eigenschapdetails

vaultUrl

De basis-URL naar de kluis

vaultUrl: string

Waarde van eigenschap

string

Methodedetails

backupCertificate(string, BackupCertificateOptions)

Hiermee wordt aangevraagd dat een back-up van het opgegeven certificaat naar de client wordt gedownload. Alle versies van het certificaat worden gedownload. Voor deze bewerking is de machtiging certificaten/back-up vereist. Gebruiksvoorbeeld:

const client = new CertificateClient(url, credentials);
await client.beginCreateCertificate("MyCertificate", {
  issuerName: "Self",
  subject: "cn=MyCert"
});
const backup = await client.backupCertificate("MyCertificate");

Hiermee wordt een back-up van een certificaat gegenereerd

function backupCertificate(certificateName: string, options?: BackupCertificateOptions)

Parameters

certificateName

string

De naam van het certificaat

options
BackupCertificateOptions

De optionele parameters

Retouren

Promise<Uint8Array | undefined>

beginCreateCertificate(string, CertificatePolicy, BeginCreateCertificateOptions)

Hiermee maakt u een nieuw certificaat. Als dit de eerste versie is, wordt de certificaatresource gemaakt. Deze functie retourneert een poller voor langdurige bewerkingen waarmee u voor onbepaalde tijd kunt wachten totdat het certificaat volledig is hersteld. Opmerking: Als u verzendt Self als van issuerName het beleid van het certificaat, wordt een zelfondertekend certificaat gemaakt.

Voor deze bewerking is de machtiging certificaten/maken vereist.

Gebruiksvoorbeeld:

const client = new CertificateClient(url, credentials);
const certificatePolicy = {
  issuerName: "Self",
  subject: "cn=MyCert"
};
const createPoller = await client.beginCreateCertificate("MyCertificate", certificatePolicy);

// The pending certificate can be obtained by calling the following method:
const pendingCertificate = createPoller.getResult();

// Serializing the poller
const serialized = createPoller.toString();

// A new poller can be created with:
// const newPoller = await client.beginCreateCertificate("MyCertificate", certificatePolicy, { resumeFrom: serialized });

// Waiting until it's done
const certificate = await createPoller.pollUntilDone();
console.log(certificate);

Hiermee maakt u een certificaat

function beginCreateCertificate(certificateName: string, policy: CertificatePolicy, options?: BeginCreateCertificateOptions)

Parameters

certificateName

string

De naam van het certificaat

policy
CertificatePolicy
options
BeginCreateCertificateOptions

Optionele parameters

Retouren

Promise<PollerLike<CreateCertificateState, KeyVaultCertificateWithPolicy>>

beginDeleteCertificate(string, BeginDeleteCertificateOptions)

De delete-bewerking is van toepassing op elk certificaat dat is opgeslagen in Azure Key Vault. DELETE kan niet worden toegepast op een afzonderlijke versie van een certificaat. Deze functie retourneert een poller voor langdurige bewerkingen waarmee u voor onbepaalde tijd kunt wachten totdat het certificaat volledig is hersteld. Voor deze bewerking is de machtiging certificaten/verwijderen vereist.

Gebruiksvoorbeeld:

const client = new CertificateClient(url, credentials);
const createPoller = await client.beginCreateCertificate("MyCertificate", {
  issuerName: "Self",
  subject: "cn=MyCert"
});
await createPoller.pollUntilDone();

const deletePoller = await client.beginDeleteCertificate("MyCertificate");

// Serializing the poller
const serialized = deletePoller.toString();

// A new poller can be created with:
// const newPoller = await client.beginDeleteCertificate("MyCertificate", { resumeFrom: serialized });

// Waiting until it's done
const deletedCertificate = await deletePoller.pollUntilDone();
console.log(deletedCertificate);

Hiermee verwijdert u een certificaat uit een opgegeven sleutelkluis.

function beginDeleteCertificate(certificateName: string, options?: BeginDeleteCertificateOptions)

Parameters

certificateName

string

De naam van het certificaat.

options
BeginDeleteCertificateOptions

De optionele parameters

Retouren

Promise<PollerLike<DeleteCertificateState, DeletedCertificate>>

beginRecoverDeletedCertificate(string, BeginRecoverDeletedCertificateOptions)

Herstelt het verwijderde certificaat in de opgegeven kluis. Deze bewerking kan alleen worden uitgevoerd op een kluis waarvoor voorlopig verwijderen is ingeschakeld. Deze bewerking Deze functie retourneert een long running operation poller waarmee u voor onbepaalde tijd kunt wachten totdat het certificaat volledig is hersteld. Voor deze bewerking is de machtiging certificaten/herstellen vereist.

Gebruiksvoorbeeld:

const client = new CertificateClient(url, credentials);

const deletePoller = await client.beginDeleteCertificate("MyCertificate");
await deletePoller.pollUntilDone();

const recoverPoller = await client.beginRecoverDeletedCertificate("MyCertificate");

// Serializing the poller
const serialized = deletePoller.toString();

// A new poller can be created with:
// const newPoller = await client.beginRecoverDeletedCertificate("MyCertificate", { resumeFrom: serialized });

// Waiting until it's done
const certificate = await recoverPoller.pollUntilDone();
console.log(certificate);

Een verwijderd certificaat herstellen

function beginRecoverDeletedCertificate(certificateName: string, options?: BeginRecoverDeletedCertificateOptions)

Parameters

certificateName

string

De naam van het verwijderde certificaat

options
BeginRecoverDeletedCertificateOptions

De optionele parameters

Retouren

Promise<PollerLike<RecoverDeletedCertificateState, KeyVaultCertificateWithPolicy>>

createIssuer(string, string, CreateIssuerOptions)

Met de bewerking createIssuer wordt de opgegeven certificaatverlener toegevoegd of bijgewerkt. Voor deze bewerking is de machtiging certificaten/setissuers vereist. Gebruiksvoorbeeld:

const client = new CertificateClient(url, credentials);
await client.createIssuer("IssuerName", "Test");

Hiermee stelt u de opgegeven certificaatverlener in.

function createIssuer(issuerName: string, provider: string, options?: CreateIssuerOptions)

Parameters

issuerName

string

De naam van de verlener.

provider

string

De provider van de verlener.

options
CreateIssuerOptions

De optionele parameters

Retouren

Promise<CertificateIssuer>

deleteCertificateOperation(string, DeleteCertificateOperationOptions)

Hiermee verwijdert u de aanmaakbewerking voor een opgegeven certificaat dat wordt gemaakt. Het certificaat wordt niet meer gemaakt. Voor deze bewerking is de machtiging certificaten/bijwerken vereist. Gebruiksvoorbeeld:

const client = new CertificateClient(url, credentials);
await client.beginCreateCertificate("MyCertificate", {
  issuerName: "Self",
  subject: "cn=MyCert"
});
await client.deleteCertificateOperation("MyCertificate");
await client.getCertificateOperation("MyCertificate"); // Throws error: Pending certificate not found: "MyCertificate"

De bewerking van een certificaat verwijderen

function deleteCertificateOperation(certificateName: string, options?: DeleteCertificateOperationOptions)

Parameters

certificateName

string

De naam van het certificaat

options
DeleteCertificateOperationOptions

De optionele parameters

Retouren

Promise<CertificateOperation>

deleteContacts(DeleteContactsOptions)

Hiermee verwijdert u alle certificaatcontactpersonen. Voor deze bewerking is de machtiging certificaten/managecontacts vereist. Gebruiksvoorbeeld:

let client = new CertificateClient(url, credentials);
await client.setContacts([{
  email: "b@b.com",
  name: "b",
  phone: "222222222222"
}]);
await client.deleteContacts();

Hiermee verwijdert u alle certificaatcontactpersonen

function deleteContacts(options?: DeleteContactsOptions)

Parameters

options
DeleteContactsOptions

De optionele parameters

Retouren

Promise<CertificateContact[] | undefined>

deleteIssuer(string, DeleteIssuerOptions)

Met de bewerking deleteIssuer wordt de opgegeven certificaatverlener definitief uit de kluis verwijderd. Voor deze bewerking is de machtiging certificates/manageissuers/deleteissuers vereist. Gebruiksvoorbeeld:

const client = new CertificateClient(url, credentials);
await client.createIssuer("IssuerName", "Provider");
await client.deleteIssuer("IssuerName");

Hiermee verwijdert u de opgegeven certificaatverlener.

function deleteIssuer(issuerName: string, options?: DeleteIssuerOptions)

Parameters

issuerName

string

De naam van de verlener.

options
DeleteIssuerOptions

De optionele parameters

Retouren

Promise<CertificateIssuer>

getCertificate(string, GetCertificateOptions)

Hiermee haalt u de meest recente informatie op die beschikbaar is van een specifiek certificaat, waaronder het beleid van het certificaat. Voor deze bewerking zijn de certificaten/machtigingen voor ophalen vereist. Gebruiksvoorbeeld:

const client = new CertificateClient(url, credentials);
const poller = await client.beginCreateCertificate("MyCertificate", {
  issuerName: "Self",
  subject: "cn=MyCert"
});
await poller.pollUntilDone();
const certificate = await client.getCertificate("MyCertificate");
console.log(certificate);

Haalt een certificaat op uit de naam van het certificaat (inclusief het certificaatbeleid)

function getCertificate(certificateName: string, options?: GetCertificateOptions)

Parameters

certificateName

string

De naam van het certificaat

options
GetCertificateOptions

De optionele parameters

Retouren

Promise<KeyVaultCertificateWithPolicy>

getCertificateOperation(string, GetCertificateOperationOptions)

Hiermee haalt u de aanmaakbewerking op die is gekoppeld aan een opgegeven certificaat. Voor deze bewerking zijn de certificaten/machtigingen voor ophalen vereist. Deze functie retourneert een poller voor langdurige bewerkingen waarmee u voor onbepaalde tijd kunt wachten totdat het certificaat volledig is hersteld. Gebruiksvoorbeeld:

const client = new CertificateClient(url, credentials);
const createPoller = await client.beginCreateCertificate("MyCertificate", {
  issuerName: "Self",
  subject: "cn=MyCert"
});

const poller = await client.getCertificateOperation("MyCertificate");
const pendingCertificate = poller.getResult();

const certificateOperation = poller.getOperationState().certificateOperation;
console.log(certificateOperation);

Hiermee haalt u de pollerbewerking van een certificaat op

function getCertificateOperation(certificateName: string, options?: GetCertificateOperationOptions)

Parameters

certificateName

string

De naam van het certificaat

options
GetCertificateOperationOptions

De optionele parameters

Retouren

Promise<PollerLike<CertificateOperationState, KeyVaultCertificateWithPolicy>>

getCertificatePolicy(string, GetCertificatePolicyOptions)

De bewerking getCertificatePolicy retourneert de opgegeven certificaatbeleidsresources in de opgegeven sleutelkluis. Voor deze bewerking zijn de certificaten/machtigingen voor ophalen vereist. Gebruiksvoorbeeld:

const client = new CertificateClient(url, credentials);
await client.beginCreateCertificate("MyCertificate", {
  issuerName: "Self",
  subject: "cn=MyCert"
});
const policy = await client.getCertificatePolicy("MyCertificate");
console.log(policy);

Hiermee haalt u het beleid van een certificaat op

function getCertificatePolicy(certificateName: string, options?: GetCertificatePolicyOptions)

Parameters

certificateName

string

De naam van het certificaat

options
GetCertificatePolicyOptions

De optionele parameters

Retouren

Promise<CertificatePolicy>

getCertificateVersion(string, string, GetCertificateVersionOptions)

Hiermee haalt u informatie op over een specifiek certificaat voor een specifieke versie. Het beleid van het certificaat wordt niet geretourneerd. Voor deze bewerking zijn de certificaten/machtigingen voor ophalen vereist. Gebruiksvoorbeeld:

const client = new CertificateClient(url, credentials);
const poller = await client.beginCreateCertificate("MyCertificate", {
  issuerName: "Self",
  subject: "cn=MyCert"
});
await poller.pollUntilDone();
const certificateWithPolicy = await client.getCertificate("MyCertificate");
const certificate = await client.getCertificateVersion("MyCertificate", certificateWithPolicy.properties.version!);
console.log(certificate);

Haalt een certificaat op van de naam van het certificaat en een opgegeven versie

function getCertificateVersion(certificateName: string, version: string, options?: GetCertificateVersionOptions)

Parameters

certificateName

string

De naam van het certificaat

version

string

De specifieke versie van het certificaat

options
GetCertificateVersionOptions

De optionele parameters

Retouren

Promise<KeyVaultCertificate>

getContacts(GetContactsOptions)

Retourneert de set resources voor certificaatcontactpersonen in de opgegeven sleutelkluis. Voor deze bewerking is de machtiging certificaten/managecontacts vereist. Gebruiksvoorbeeld:

let client = new CertificateClient(url, credentials);
await client.setContacts([{
  email: "b@b.com",
  name: "b",
  phone: "222222222222"
}]);
const contacts = await client.getContacts();
console.log(contacts);

Hiermee stelt u de certificaatcontactpersonen in.

function getContacts(options?: GetContactsOptions)

Parameters

options
GetContactsOptions

De optionele parameters

Retouren

Promise<CertificateContact[] | undefined>

getDeletedCertificate(string, GetDeletedCertificateOptions)

haalt de verwijderde certificaatgegevens plus de bijbehorende kenmerken op, zoals retentie-interval, geplande permanente verwijdering en het huidige herstelniveau voor verwijdering. Voor deze bewerking zijn de certificaten/machtigingen voor ophalen vereist. Gebruiksvoorbeeld:

const client = new CertificateClient(url, credentials);
const deletedCertificate = await client.getDeletedCertificate("MyDeletedCertificate");
console.log("Deleted certificate:", deletedCertificate);

Hiermee haalt u een verwijderd certificaat op

function getDeletedCertificate(certificateName: string, options?: GetDeletedCertificateOptions)

Parameters

certificateName

string

De naam van het certificaat

options
GetDeletedCertificateOptions

De optionele parameters

Retouren

Promise<DeletedCertificate>

getIssuer(string, GetIssuerOptions)

De bewerking getIssuer retourneert de opgegeven certificaatverlenerresources in de opgegeven sleutelkluis. Voor deze bewerking is de machtiging certificates/manageissuers/getissuers vereist. Gebruiksvoorbeeld:

const client = new CertificateClient(url, credentials);
await client.createIssuer("IssuerName", "Test");
const certificateIssuer = await client.getIssuer("IssuerName");
console.log(certificateIssuer);

Haalt de door hem opgegeven certificaatverlener op.

function getIssuer(issuerName: string, options?: GetIssuerOptions)

Parameters

issuerName

string

De naam van de verlener.

options
GetIssuerOptions

De optionele parameters

Retouren

Promise<CertificateIssuer>

importCertificate(string, Uint8Array, ImportCertificateOptions)

Hiermee importeert u een bestaand geldig certificaat met een persoonlijke sleutel in Azure Key Vault. Het certificaat dat moet worden geïmporteerd, kan de PFX- of PEM-indeling hebben. Als het certificaat de PEM-indeling heeft, moet het PEM-bestand de sleutel en x509-certificaten bevatten. Voor deze bewerking is de machtiging certificaten/importeren vereist. Gebruiksvoorbeeld:

const client = new CertificateClient(url, credentials);
// See: @azure/keyvault-secrets
const certificateSecret = await secretClient.getSecret("MyCertificate");
const base64EncodedCertificate = certificateSecret.value!;
let buffer: Uint8Array;

if (isNode) {
  buffer = Buffer.from(base64EncodedCertificate, "base64");
} else {
  buffer = Uint8Array.from(atob(base64EncodedCertificate), (c) => c.charCodeAt(0));
}

await client.importCertificate("MyCertificate", buffer);

Importeert een certificaat uit de geheime waarde van een certificaat

function importCertificate(certificateName: string, certificateBytes: Uint8Array, options?: ImportCertificateOptions)

Parameters

certificateName

string

De naam van het certificaat

certificateBytes

Uint8Array

De pfx- of ASCII PEM-opgemaakte waarde van het certificaat dat zowel de X.509-certificaten als de persoonlijke sleutel bevat

options
ImportCertificateOptions

De optionele parameters

Retouren

Promise<KeyVaultCertificateWithPolicy>

listDeletedCertificates(ListDeletedCertificatesOptions)

Haalt de certificaten op in de huidige kluis die de status Verwijderd hebben en gereed zijn voor herstel of opschoning. Deze bewerking omvat gegevens die specifiek zijn voor verwijdering. Voor deze bewerking is de machtiging certificaten/get/list vereist. Deze bewerking kan alleen worden ingeschakeld voor kluizen waarvoor voorlopig verwijderen is ingeschakeld. Gebruiksvoorbeeld:

const client = new CertificateClient(url, credentials);
for await (const deletedCertificate of client.listDeletedCertificates()) {
  console.log(deletedCertificate);
}
for await (const page of client.listDeletedCertificates().byPage()) {
  for (const deletedCertificate of page) {
    console.log(deletedCertificate);
  }
}

Lijst met verwijderde certificaten

function listDeletedCertificates(options?: ListDeletedCertificatesOptions)

Parameters

options
ListDeletedCertificatesOptions

De optionele parameters

Retouren

PagedAsyncIterableIterator<DeletedCertificate>

listPropertiesOfCertificates(ListPropertiesOfCertificatesOptions)

Hiermee wordt de nieuwste versie van alle certificaten in de kluis herhaald. De volledige certificaat-id en -kenmerken worden opgegeven in het antwoord. Er worden geen waarden geretourneerd voor de certificaten. Voor deze bewerking is de machtiging certificaten/lijst vereist. Gebruiksvoorbeeld:

const client = new CertificateClient(url, credentials);
// All in one call
for await (const certificateProperties of client.listPropertiesOfCertificates()) {
  console.log(certificateProperties);
}
// By pages
for await (const page of client.listPropertiesOfCertificates().byPage()) {
  for (const certificateProperties of page) {
    console.log(certificateProperties);
  }
}

Alle versies van het opgegeven certificaat weergeven.

function listPropertiesOfCertificates(options?: ListPropertiesOfCertificatesOptions)

Parameters

options
ListPropertiesOfCertificatesOptions

De optionele parameters

Retouren

PagedAsyncIterableIterator<CertificateProperties>

listPropertiesOfCertificateVersions(string, ListPropertiesOfCertificateVersionsOptions)

Retourneert de versies van een certificaat in de opgegeven sleutelkluis. Voor deze bewerking is de machtiging certificaten/lijst vereist. Gebruiksvoorbeeld:

const client = new CertificateClient(url, credentials);
for await (const certificateProperties of client.listPropertiesOfCertificateVersions("MyCertificate")) {
  console.log(certificateProperties.version!);
}

De versies van een certificaat weergeven.

function listPropertiesOfCertificateVersions(certificateName: string, options?: ListPropertiesOfCertificateVersionsOptions)

Parameters

certificateName

string

De naam van het certificaat.

options
ListPropertiesOfCertificateVersionsOptions

De optionele parameters

Retouren

PagedAsyncIterableIterator<CertificateProperties>

listPropertiesOfIssuers(ListPropertiesOfIssuersOptions)

Retourneert de set resources voor certificaatverleners in de opgegeven sleutelkluis. Voor deze bewerking is de machtiging certificates/manageissuers/getissuers vereist. Gebruiksvoorbeeld:

const client = new CertificateClient(url, credentials);
await client.createIssuer("IssuerName", "Test");
// All in one call
for await (const issuerProperties of client.listPropertiesOfIssuers()) {
  console.log(issuerProperties);
}
// By pages
for await (const page of client.listPropertiesOfIssuers().byPage()) {
  for (const issuerProperties of page) {
    console.log(issuerProperties);
  }
}

De certificaatverleners weergeven.

function listPropertiesOfIssuers(options?: ListPropertiesOfIssuersOptions)

Parameters

options
ListPropertiesOfIssuersOptions

De optionele parameters

Retouren

PagedAsyncIterableIterator<IssuerProperties>

mergeCertificate(string, Uint8Array[], MergeCertificateOptions)

Hiermee wordt een certificaat of certificaatketen samengevoegd met een sleutelpaar dat momenteel beschikbaar is in de service. Voor deze bewerking is de machtiging certificaten/maken vereist. Gebruiksvoorbeeld:

const client = new CertificateClient(url, credentials);
await client.beginCreateCertificate("MyCertificate", {
  issuerName: "Unknown",
  subject: "cn=MyCert"
});
const poller = await client.getCertificateOperation("MyCertificate");
const { csr } = poller.getOperationState().certificateOperation!;
const base64Csr = Buffer.from(csr!).toString("base64");
const wrappedCsr = ["-----BEGIN CERTIFICATE REQUEST-----", base64Csr, "-----END CERTIFICATE REQUEST-----"].join("\n");

const fs = require("fs");
fs.writeFileSync("test.csr", wrappedCsr);

// Certificate available locally made using:
//   openssl genrsa -out ca.key 2048
//   openssl req -new -x509 -key ca.key -out ca.crt
// You can read more about how to create a fake certificate authority here: https://gist.github.com/Soarez/9688998

const childProcess = require("child_process");
childProcess.execSync("openssl x509 -req -in test.csr -CA ca.crt -CAkey ca.key -CAcreateserial -out test.crt");
const base64Crt = fs.readFileSync("test.crt").toString().split("\n").slice(1, -1).join("");

await client.mergeCertificate("MyCertificate", [Buffer.from(base64Crt)]);

Hiermee wordt een ondertekende certificaataanvraag samengevoegd in een certificaat in behandeling

function mergeCertificate(certificateName: string, x509Certificates: Uint8Array[], options?: MergeCertificateOptions)

Parameters

certificateName

string

De naam van het certificaat

x509Certificates

Uint8Array[]

De samen te voegen certificaten

options
MergeCertificateOptions

De optionele parameters

Retouren

Promise<KeyVaultCertificateWithPolicy>

purgeDeletedCertificate(string, PurgeDeletedCertificateOptions)

Voert een onomkeerbare verwijdering van het opgegeven certificaat uit, zonder mogelijkheid tot herstel. De bewerking is niet beschikbaar als het herstelniveau niet 'Opschoonbaar' opgeeft. Voor deze bewerking is de machtiging certificaat/opschonen vereist. Gebruiksvoorbeeld:

const client = new CertificateClient(url, credentials);
const deletePoller = await client.beginDeleteCertificate("MyCertificate");
await deletePoller.pollUntilDone();
// Deleting a certificate takes time, make sure to wait before purging it
client.purgeDeletedCertificate("MyCertificate");

Hiermee haalt u een verwijderd certificaat op

function purgeDeletedCertificate(certificateName: string, options?: PurgeDeletedCertificateOptions)

Parameters

certificateName

string

De naam van het verwijderde certificaat dat u wilt opschonen

options
PurgeDeletedCertificateOptions

De optionele parameters

Retouren

Promise<null>

restoreCertificateBackup(Uint8Array, RestoreCertificateBackupOptions)

Hiermee herstelt u een back-up van een certificaat en alle bijbehorende versies naar een kluis. Voor deze bewerking is de machtiging certificaten/herstellen vereist. Gebruiksvoorbeeld:

const client = new CertificateClient(url, credentials);
await client.beginCreateCertificate("MyCertificate", {
  issuerName: "Self",
  subject: "cn=MyCert"
});
const backup = await client.backupCertificate("MyCertificate");
const poller = await client.beginDeleteCertificate("MyCertificate");
await poller.pollUntilDone();
// Some time is required before we're able to restore the certificate
await client.restoreCertificateBackup(backup!);

Een certificaat terugzetten vanuit een back-up

function restoreCertificateBackup(backup: Uint8Array, options?: RestoreCertificateBackupOptions)

Parameters

backup

Uint8Array

Het back-upcertificaat waaruit moet worden hersteld

options
RestoreCertificateBackupOptions

De optionele parameters

Retouren

Promise<KeyVaultCertificateWithPolicy>

setContacts(CertificateContact[], SetContactsOptions)

Hiermee stelt u de certificaatcontactpersonen voor de sleutelkluis in. Voor deze bewerking is de machtiging certificaten/managecontacts vereist. Gebruiksvoorbeeld:

let client = new CertificateClient(url, credentials);
await client.setContacts([{
  email: "b@b.com",
  name: "b",
  phone: "222222222222"
}]);

Hiermee stelt u de certificaatcontactpersonen in.

function setContacts(contacts: CertificateContact[], options?: SetContactsOptions)

Parameters

contacts

CertificateContact[]

De contactpersonen die moeten worden gebruikt

options
SetContactsOptions

De optionele parameters

Retouren

Promise<CertificateContact[] | undefined>

updateCertificatePolicy(string, CertificatePolicy, UpdateCertificatePolicyOptions)

Updates het certificaatbeleid voor het opgegeven certificaat. Voor deze bewerking is de machtiging certificaten/bijwerken vereist. Hiermee haalt u het beleid van een certificaat op

function updateCertificatePolicy(certificateName: string, policy: CertificatePolicy, options?: UpdateCertificatePolicyOptions)

Parameters

certificateName

string

De naam van het certificaat

policy
CertificatePolicy

Het certificaatbeleid

options
UpdateCertificatePolicyOptions

De optionele parameters

Retouren

Promise<CertificatePolicy>

updateCertificateProperties(string, string, UpdateCertificateOptions)

Past de opgegeven update toe op het opgegeven certificaat; de enige elementen die zijn bijgewerkt, zijn de kenmerken van het certificaat. Voor deze bewerking is de machtiging certificaten/bijwerken vereist. Gebruiksvoorbeeld:

const client = new CertificateClient(url, credentials);
await client.beginCreateCertificate("MyCertificate", {
  issuerName: "Self",
  subject: "cn=MyCert"
});
await client.updateCertificateProperties("MyCertificate", "", {
  tags: {
    customTag: "value"
  }
});

een certificaat Updates

function updateCertificateProperties(certificateName: string, version: string, options?: UpdateCertificateOptions)

Parameters

certificateName

string

De naam van het certificaat

version

string

De versie van het certificaat dat moet worden bijgewerkt

options
UpdateCertificateOptions

De opties, inclusief wat u moet bijwerken

Retouren

Promise<KeyVaultCertificate>

updateIssuer(string, UpdateIssuerOptions)

De updateIssuer-bewerking voert een update uit op de opgegeven certificaatverlenerentiteit. Voor deze bewerking is de machtiging certificaten/setissuers vereist. Gebruiksvoorbeeld:

const client = new CertificateClient(url, credentials);
await client.createIssuer("IssuerName", "Test");
await client.updateIssuer("IssuerName", {
  provider: "Provider2"
});

Updates de opgegeven certificaatverlener.

function updateIssuer(issuerName: string, options?: UpdateIssuerOptions)

Parameters

issuerName

string

De naam van de verlener.

options
UpdateIssuerOptions

De optionele parameters

Retouren

Promise<CertificateIssuer>