Megosztás a következőn keresztül:

CertificateClient class

  • Referencia
Csomag:
@azure/keyvault-certificates

A KeyVault-tanúsítványok funkcióval kommunikáló ügyfél

Konstruktorok

CertificateClient(string, TokenCredential, CertificateClientOptions)

Létrehozza a CertificateClient egy példányát.

Tulajdonságok

vaultUrl

A tároló alap URL-címe

Metódusok

backupCertificate(string, OperationOptions)

Kéri, hogy a megadott tanúsítvány biztonsági másolatát letöltse az ügyfélre. A rendszer letölti a tanúsítvány összes verzióját. Ehhez a művelethez tanúsítványok/biztonsági mentési engedély szükséges.

Példahasználat:

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

Tanúsítvány biztonsági másolatának létrehozása
beginCreateCertificate(string, CertificatePolicy, BeginCreateCertificateOptions)

Új tanúsítványt hoz létre. Ha ez az első verzió, a rendszer létrehozza a tanúsítványerőforrást. Ez a függvény egy hosszú ideig futó művelet lekérdezését adja vissza, amely lehetővé teszi, hogy határozatlan ideig várjon, amíg a tanúsítvány teljesen helyre nem áll.

Megjegyzés: A tanúsítvány házirendjeként issuerName való küldés Self önaláírt tanúsítványt hoz létre.

Ehhez a művelethez a tanúsítványokra/létrehozásra vonatkozó engedély szükséges.

Példahasználat:

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);

Tanúsítvány létrehozása
beginDeleteCertificate(string, CertificatePollerOptions)

A DELETE művelet az Azure Key Vault-ban tárolt összes tanúsítványra vonatkozik. A DELETE nem alkalmazható a tanúsítvány egyes verzióira. Ez a függvény egy hosszú ideig futó művelet lekérdezését adja vissza, amely lehetővé teszi, hogy határozatlan ideig várjon, amíg a tanúsítvány teljesen helyre nem áll.

Ehhez a művelethez tanúsítványokra/törlési engedélyekre van szükség.

Példahasználat:

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);

Egy tanúsítvány törlése egy megadott kulcstartóból.
beginRecoverDeletedCertificate(string, CertificatePollerOptions)

Helyreállítja a törölt tanúsítványt a megadott tárolóban. Ez a művelet csak helyreállítható törlést engedélyező tárolón nyitható meg. Ez a művelet: Ez a függvény egy hosszú ideig futó művelet lekérdezését adja vissza, amely lehetővé teszi, hogy határozatlan ideig várjon a tanúsítvány teljes helyreállításáig.

Ehhez a művelethez tanúsítványokra/helyreállításra vonatkozó engedély szükséges.

Példahasználat:

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);

Törölt tanúsítvány helyreállítása
createIssuer(string, string, CreateIssuerOptions)

A createIssuer művelet hozzáadja vagy frissíti a megadott tanúsítványkibocsátót. Ehhez a művelethez tanúsítvány-/setissuers-engedély szükséges.

Példahasználat:

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

Beállítja a megadott tanúsítványkiállítót.
deleteCertificateOperation(string, OperationOptions)

Törli a létrehozás folyamatban lévő adott tanúsítvány létrehozási műveletét. A tanúsítvány már nem jön létre. Ehhez a művelethez tanúsítványokra/frissítési engedélyekre van szükség.

Példahasználat:

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"

Tanúsítvány műveletének törlése
deleteContacts(OperationOptions)

Törli az összes tanúsítványpartnert. Ehhez a művelethez tanúsítvány/managecontacts engedély szükséges.

Példahasználat:

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

A tanúsítvány összes névjegyének törlése
deleteIssuer(string, OperationOptions)

A deleteIssuer művelet véglegesen eltávolítja a megadott tanúsítványkibocsátót a tárolóból. Ehhez a művelethez tanúsítvány/manageissuers/deleteissuers engedély szükséges.

Példahasználat:

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

Törli a megadott tanúsítványkibocsátót.
getCertificate(string, OperationOptions)

Lekéri egy adott tanúsítvány legfrissebb információját, beleértve a tanúsítvány szabályzatát is. Ehhez a művelethez tanúsítványokra/lekérési engedélyekre van szükség.

Példahasználat:

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);

Lekéri a tanúsítványt a tanúsítvány nevéből (a tanúsítványházirendet is beleértve)
getCertificateOperation(string, CertificatePollerOptions)

Lekéri a megadott tanúsítvánnyal társított létrehozási műveletet. Ehhez a művelethez tanúsítványokra/lekérési engedélyekre van szükség. Ez a függvény egy hosszú ideig futó művelet lekérdezését adja vissza, amely lehetővé teszi, hogy határozatlan ideig várjon, amíg a tanúsítvány teljesen helyre nem áll.

Példahasználat:

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);

Lekéri egy tanúsítvány lekérdezési műveletét
getCertificatePolicy(string, OperationOptions)

A getCertificatePolicy művelet visszaadja a megadott tanúsítványházirend-erőforrásokat a megadott kulcstartóban. Ehhez a művelethez tanúsítványokra/lekérési engedélyekre van szükség.

Példahasználat:

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

Lekéri a tanúsítvány szabályzatát
getCertificateVersion(string, string, OperationOptions)

Egy adott tanúsítvánnyal kapcsolatos információkat kap egy adott verzióról. Nem adja vissza a tanúsítvány szabályzatát. Ehhez a művelethez tanúsítványokra/lekérési engedélyekre van szükség.

Példahasználat:

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);

Tanúsítvány lekérése a tanúsítvány nevéből és egy megadott verzióból
getContacts(OperationOptions)

A megadott kulcstartóban található tanúsítvány-kapcsolati erőforrások készletét adja vissza. Ehhez a művelethez tanúsítvány/managecontacts engedély szükséges.

Példahasználat:

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);

Beállítja a tanúsítvány névjegyeit.
getDeletedCertificate(string, OperationOptions)

lekéri a törölt tanúsítvány adatait és attribútumait, például a megőrzési időközt, az ütemezett végleges törlést és az aktuális törlés helyreállítási szintjét. Ehhez a művelethez tanúsítványokra/lekérési engedélyekre van szükség.

Példahasználat:

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

Törölt tanúsítvány lekérhető
getIssuer(string, OperationOptions)

A getIssuer művelet visszaadja a megadott tanúsítványkibocsátó erőforrásokat a megadott kulcstartóban. Ehhez a művelethez tanúsítványok/manageissuers/getissuers engedély szükséges.

Példahasználat:

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

Lekéri a megadott tanúsítványkiállítót.
importCertificate(string, Uint8Array, ImportCertificateOptions)

Importál egy meglévő, titkos kulcsot tartalmazó érvényes tanúsítványt az Azure Key Vault. Az importálandó tanúsítvány PFX vagy PEM formátumban is lehet. Ha a tanúsítvány PEM formátumban van, a PEM-fájlnak tartalmaznia kell a kulcsot és az x509-tanúsítványokat. Ehhez a művelethez a tanúsítványokra/importálásra vonatkozó engedély szükséges.

Példahasználat:

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);

Tanúsítvány importálása a tanúsítvány titkos értékéből
listDeletedCertificates(ListDeletedCertificatesOptions)

Lekéri azokat a tanúsítványokat az aktuális tárolóban, amelyek törölt állapotban vannak, és készen állnak a helyreállításra vagy a törlésre. Ez a művelet törléssel kapcsolatos információkat tartalmaz. Ehhez a művelethez tanúsítvány-/lekérési/listázási engedély szükséges. Ez a művelet csak helyreállítható törlést engedélyező tárolókon engedélyezhető.

Példahasználat:

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);
  }
}

Törölt tanúsítványok listái
listPropertiesOfCertificates(ListPropertiesOfCertificatesOptions)

Iterálja a tárolóban található összes tanúsítvány legújabb verzióját. A teljes tanúsítványazonosítót és attribútumokat a válaszban adták meg. A rendszer nem ad vissza értékeket a tanúsítványokhoz. Ehhez a művelethez tanúsítvány-/listaengedély szükséges.

Példahasználat:

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);
  }
}

A megadott tanúsítvány összes verziójának listázása.
listPropertiesOfCertificateVersions(string, OperationOptions)

A megadott kulcstartóban lévő tanúsítvány verzióit adja vissza. Ehhez a művelethez tanúsítvány-/listaengedély szükséges.

Példahasználat:

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

A tanúsítványok verzióinak listázása.
listPropertiesOfIssuers(OperationOptions)

A tanúsítványkibocsátó erőforrásainak készletét adja vissza a megadott kulcstartóban. Ehhez a művelethez tanúsítványok/manageissuers/getissuers engedély szükséges.

Példahasználat:

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);
  }
}

Sorolja fel a tanúsítványkiállítókat.
mergeCertificate(string, Uint8Array[], OperationOptions)

Egy tanúsítvány- vagy tanúsítványlánc egyesítését hajtja végre a szolgáltatásban jelenleg elérhető kulcspárral. Ehhez a művelethez a tanúsítványokra/létrehozásra vonatkozó engedély szükséges.

Példahasználat:

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)]);

Aláírt tanúsítványkérelmet egyesít függőben lévő tanúsítványsá
purgeDeletedCertificate(string, OperationOptions)

A megadott tanúsítvány visszafordíthatatlan törlését hajtja végre, helyreállítás lehetősége nélkül. A művelet nem érhető el, ha a helyreállítási szint nem adja meg a "Kiüríthető" értéket. Ehhez a művelethez tanúsítvány-/véglegesítési engedély szükséges.

Példahasználat:

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");

Törölt tanúsítvány lekérhető
restoreCertificateBackup(Uint8Array, OperationOptions)

Visszaállít egy biztonsági másolatban szereplő tanúsítványt és annak összes verzióját egy tárolóba. Ehhez a művelethez tanúsítványokra/visszaállítási engedélyre van szükség.

Példahasználat:

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!);

Tanúsítvány visszaállítása biztonsági másolatból
setContacts(CertificateContact[], OperationOptions)

Beállítja a kulcstartóhoz tartozó tanúsítvány névjegyeit. Ehhez a művelethez tanúsítvány/managecontacts engedély szükséges.

Példahasználat:

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

Beállítja a tanúsítvány névjegyeit.
updateCertificatePolicy(string, CertificatePolicy, OperationOptions)

Frissítések a megadott tanúsítvány tanúsítványszabályzatát. Ehhez a művelethez tanúsítványokra/frissítési engedélyre van szükség. Tanúsítvány szabályzatának lekérve
updateCertificateProperties(string, string, UpdateCertificateOptions)

A megadott frissítést alkalmazza a megadott tanúsítványra; az egyetlen frissített elem a tanúsítvány attribútumai. Ehhez a művelethez tanúsítványokra/frissítési engedélyre van szükség.

Példahasználat:

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

// You may pass an empty string for version which will update
// the latest version of the certificate
await client.updateCertificateProperties("MyCertificate", "", {
  tags: {
    customTag: "value"
  }
});

tanúsítvány Frissítések
updateIssuer(string, UpdateIssuerOptions)

Az updateIssuer művelet egy frissítést hajt végre a megadott tanúsítványkibocsátó entitáson. Ehhez a művelethez tanúsítvány/setissuers engedély szükséges.

Példahasználat:

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

Frissítések a megadott tanúsítványkibocsátó.

Konstruktor adatai

CertificateClient(string, TokenCredential, CertificateClientOptions)

Létrehozza a CertificateClient egy példányát.

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

Paraméterek

vaultUrl

string

a tároló alap URL-címe. Ellenőrizze, hogy az URL-cím érvényes Key Vault erőforrásra hivatkozik-e. További részletek: https://aka.ms/azsdk/blog/vault-uri.

credential
TokenCredential

Egy objektum, amely a TokenCredential szolgáltatásnak küldött kérések hitelesítéséhez használt felületet valósítja meg. @azure/identity A csomag használatával hozzon létre egy, az igényeinek megfelelő hitelesítő adatokat.

clientOptions
CertificateClientOptions

A Key Vault API-kérések konfigurálásához használt folyamatbeállítások. Hagyja ki ezt a paramétert az alapértelmezett folyamatkonfiguráció használatához.

Tulajdonság adatai

vaultUrl

A tároló alap URL-címe

vaultUrl: string

Tulajdonság értéke

string

Metódus adatai

backupCertificate(string, OperationOptions)

Kéri, hogy a megadott tanúsítvány biztonsági másolatát letöltse az ügyfélre. A rendszer letölti a tanúsítvány összes verzióját. Ehhez a művelethez tanúsítványok/biztonsági mentési engedély szükséges.

Példahasználat:

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

Tanúsítvány biztonsági másolatának létrehozása

function backupCertificate(certificateName: string, options?: OperationOptions): Promise<undefined | Uint8Array>

Paraméterek

certificateName

string

A tanúsítvány neve

options
OperationOptions

A választható paraméterek

Válaszok

Promise<undefined | Uint8Array>

beginCreateCertificate(string, CertificatePolicy, BeginCreateCertificateOptions)

Új tanúsítványt hoz létre. Ha ez az első verzió, a rendszer létrehozza a tanúsítványerőforrást. Ez a függvény egy hosszú ideig futó művelet lekérdezését adja vissza, amely lehetővé teszi, hogy határozatlan ideig várjon, amíg a tanúsítvány teljesen helyre nem áll.

Megjegyzés: A tanúsítvány házirendjeként issuerName való küldés Self önaláírt tanúsítványt hoz létre.

Ehhez a művelethez a tanúsítványokra/létrehozásra vonatkozó engedély szükséges.

Példahasználat:

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);

Tanúsítvány létrehozása

function beginCreateCertificate(certificateName: string, policy: CertificatePolicy, options?: BeginCreateCertificateOptions): Promise<PollerLikeWithCancellation<CreateCertificateState, KeyVaultCertificateWithPolicy>>

Paraméterek

certificateName

string

A tanúsítvány neve

policy
CertificatePolicy
options
BeginCreateCertificateOptions

Választható paraméterek

Válaszok

Promise<PollerLikeWithCancellation<CreateCertificateState, KeyVaultCertificateWithPolicy>>

beginDeleteCertificate(string, CertificatePollerOptions)

A DELETE művelet az Azure Key Vault-ban tárolt összes tanúsítványra vonatkozik. A DELETE nem alkalmazható a tanúsítvány egyes verzióira. Ez a függvény egy hosszú ideig futó művelet lekérdezését adja vissza, amely lehetővé teszi, hogy határozatlan ideig várjon, amíg a tanúsítvány teljesen helyre nem áll.

Ehhez a művelethez tanúsítványokra/törlési engedélyekre van szükség.

Példahasználat:

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);

Egy tanúsítvány törlése egy megadott kulcstartóból.

function beginDeleteCertificate(certificateName: string, options?: CertificatePollerOptions): Promise<PollerLike<DeleteCertificateState, DeletedCertificate>>

Paraméterek

certificateName

string

A tanúsítvány neve.

options
CertificatePollerOptions

A választható paraméterek

Válaszok

Promise<PollerLike<DeleteCertificateState, DeletedCertificate>>

beginRecoverDeletedCertificate(string, CertificatePollerOptions)

Helyreállítja a törölt tanúsítványt a megadott tárolóban. Ez a művelet csak helyreállítható törlést engedélyező tárolón nyitható meg. Ez a művelet: Ez a függvény egy hosszú ideig futó művelet lekérdezését adja vissza, amely lehetővé teszi, hogy határozatlan ideig várjon a tanúsítvány teljes helyreállításáig.

Ehhez a művelethez tanúsítványokra/helyreállításra vonatkozó engedély szükséges.

Példahasználat:

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);

Törölt tanúsítvány helyreállítása

function beginRecoverDeletedCertificate(certificateName: string, options?: CertificatePollerOptions): Promise<PollerLike<RecoverDeletedCertificateState, KeyVaultCertificateWithPolicy>>

Paraméterek

certificateName

string

A törölt tanúsítvány neve

options
CertificatePollerOptions

A választható paraméterek

Válaszok

Promise<PollerLike<RecoverDeletedCertificateState, KeyVaultCertificateWithPolicy>>

createIssuer(string, string, CreateIssuerOptions)

A createIssuer művelet hozzáadja vagy frissíti a megadott tanúsítványkibocsátót. Ehhez a művelethez tanúsítvány-/setissuers-engedély szükséges.

Példahasználat:

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

Beállítja a megadott tanúsítványkiállítót.

function createIssuer(issuerName: string, provider: string, options?: CreateIssuerOptions): Promise<CertificateIssuer>

Paraméterek

issuerName

string

A kibocsátó neve.

provider

string

A kibocsátó szolgáltatója.

options
CreateIssuerOptions

A választható paraméterek

Válaszok

Promise<CertificateIssuer>

deleteCertificateOperation(string, OperationOptions)

Törli a létrehozás folyamatban lévő adott tanúsítvány létrehozási műveletét. A tanúsítvány már nem jön létre. Ehhez a művelethez tanúsítványokra/frissítési engedélyekre van szükség.

Példahasználat:

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"

Tanúsítvány műveletének törlése

function deleteCertificateOperation(certificateName: string, options?: OperationOptions): Promise<CertificateOperation>

Paraméterek

certificateName

string

A tanúsítvány neve

options
OperationOptions

A választható paraméterek

Válaszok

Promise<CertificateOperation>

deleteContacts(OperationOptions)

Törli az összes tanúsítványpartnert. Ehhez a művelethez tanúsítvány/managecontacts engedély szükséges.

Példahasználat:

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

A tanúsítvány összes névjegyének törlése

function deleteContacts(options?: OperationOptions): Promise<undefined | CertificateContact[]>

Paraméterek

options
OperationOptions

A választható paraméterek

Válaszok

Promise<undefined | CertificateContact[]>

deleteIssuer(string, OperationOptions)

A deleteIssuer művelet véglegesen eltávolítja a megadott tanúsítványkibocsátót a tárolóból. Ehhez a művelethez tanúsítvány/manageissuers/deleteissuers engedély szükséges.

Példahasználat:

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

Törli a megadott tanúsítványkibocsátót.

function deleteIssuer(issuerName: string, options?: OperationOptions): Promise<CertificateIssuer>

Paraméterek

issuerName

string

A kibocsátó neve.

options
OperationOptions

A választható paraméterek

Válaszok

Promise<CertificateIssuer>

getCertificate(string, OperationOptions)

Lekéri egy adott tanúsítvány legfrissebb információját, beleértve a tanúsítvány szabályzatát is. Ehhez a művelethez tanúsítványokra/lekérési engedélyekre van szükség.

Példahasználat:

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);

Lekéri a tanúsítványt a tanúsítvány nevéből (a tanúsítványházirendet is beleértve)

function getCertificate(certificateName: string, options?: OperationOptions): Promise<KeyVaultCertificateWithPolicy>

Paraméterek

certificateName

string

A tanúsítvány neve

options
OperationOptions

A választható paraméterek

Válaszok

Promise<KeyVaultCertificateWithPolicy>

getCertificateOperation(string, CertificatePollerOptions)

Lekéri a megadott tanúsítvánnyal társított létrehozási műveletet. Ehhez a művelethez tanúsítványokra/lekérési engedélyekre van szükség. Ez a függvény egy hosszú ideig futó művelet lekérdezését adja vissza, amely lehetővé teszi, hogy határozatlan ideig várjon, amíg a tanúsítvány teljesen helyre nem áll.

Példahasználat:

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);

Lekéri egy tanúsítvány lekérdezési műveletét

function getCertificateOperation(certificateName: string, options?: CertificatePollerOptions): Promise<PollerLikeWithCancellation<CertificateOperationState, KeyVaultCertificateWithPolicy>>

Paraméterek

certificateName

string

A tanúsítvány neve

options
CertificatePollerOptions

A választható paraméterek

Válaszok

Promise<PollerLikeWithCancellation<CertificateOperationState, KeyVaultCertificateWithPolicy>>

getCertificatePolicy(string, OperationOptions)

A getCertificatePolicy művelet visszaadja a megadott tanúsítványházirend-erőforrásokat a megadott kulcstartóban. Ehhez a művelethez tanúsítványokra/lekérési engedélyekre van szükség.

Példahasználat:

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

Lekéri a tanúsítvány szabályzatát

function getCertificatePolicy(certificateName: string, options?: OperationOptions): Promise<CertificatePolicy>

Paraméterek

certificateName

string

A tanúsítvány neve

options
OperationOptions

A választható paraméterek

Válaszok

Promise<CertificatePolicy>

getCertificateVersion(string, string, OperationOptions)

Egy adott tanúsítvánnyal kapcsolatos információkat kap egy adott verzióról. Nem adja vissza a tanúsítvány szabályzatát. Ehhez a művelethez tanúsítványokra/lekérési engedélyekre van szükség.

Példahasználat:

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);

Tanúsítvány lekérése a tanúsítvány nevéből és egy megadott verzióból

function getCertificateVersion(certificateName: string, version: string, options?: OperationOptions): Promise<KeyVaultCertificate>

Paraméterek

certificateName

string

A tanúsítvány neve

version

string

A tanúsítvány adott verziója

options
OperationOptions

A választható paraméterek

Válaszok

Promise<KeyVaultCertificate>

getContacts(OperationOptions)

A megadott kulcstartóban található tanúsítvány-kapcsolati erőforrások készletét adja vissza. Ehhez a művelethez tanúsítvány/managecontacts engedély szükséges.

Példahasználat:

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);

Beállítja a tanúsítvány névjegyeit.

function getContacts(options?: OperationOptions): Promise<undefined | CertificateContact[]>

Paraméterek

options
OperationOptions

A választható paraméterek

Válaszok

Promise<undefined | CertificateContact[]>

getDeletedCertificate(string, OperationOptions)

lekéri a törölt tanúsítvány adatait és attribútumait, például a megőrzési időközt, az ütemezett végleges törlést és az aktuális törlés helyreállítási szintjét. Ehhez a művelethez tanúsítványokra/lekérési engedélyekre van szükség.

Példahasználat:

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

Törölt tanúsítvány lekérhető

function getDeletedCertificate(certificateName: string, options?: OperationOptions): Promise<DeletedCertificate>

Paraméterek

certificateName

string

A tanúsítvány neve

options
OperationOptions

A választható paraméterek

Válaszok

Promise<DeletedCertificate>

getIssuer(string, OperationOptions)

A getIssuer művelet visszaadja a megadott tanúsítványkibocsátó erőforrásokat a megadott kulcstartóban. Ehhez a művelethez tanúsítványok/manageissuers/getissuers engedély szükséges.

Példahasználat:

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

Lekéri a megadott tanúsítványkiállítót.

function getIssuer(issuerName: string, options?: OperationOptions): Promise<CertificateIssuer>

Paraméterek

issuerName

string

A kibocsátó neve.

options
OperationOptions

A választható paraméterek

Válaszok

Promise<CertificateIssuer>

importCertificate(string, Uint8Array, ImportCertificateOptions)

Importál egy meglévő, titkos kulcsot tartalmazó érvényes tanúsítványt az Azure Key Vault. Az importálandó tanúsítvány PFX vagy PEM formátumban is lehet. Ha a tanúsítvány PEM formátumban van, a PEM-fájlnak tartalmaznia kell a kulcsot és az x509-tanúsítványokat. Ehhez a művelethez a tanúsítványokra/importálásra vonatkozó engedély szükséges.

Példahasználat:

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);

Tanúsítvány importálása a tanúsítvány titkos értékéből

function importCertificate(certificateName: string, certificateBytes: Uint8Array, options?: ImportCertificateOptions): Promise<KeyVaultCertificateWithPolicy>

Paraméterek

certificateName

string

A tanúsítvány neve

certificateBytes

Uint8Array

Az X.509-tanúsítványokat és a titkos kulcsot tartalmazó tanúsítvány PFX vagy ASCII PEM formátumú értéke

options
ImportCertificateOptions

A választható paraméterek

Válaszok

Promise<KeyVaultCertificateWithPolicy>

listDeletedCertificates(ListDeletedCertificatesOptions)

Lekéri azokat a tanúsítványokat az aktuális tárolóban, amelyek törölt állapotban vannak, és készen állnak a helyreállításra vagy a törlésre. Ez a művelet törléssel kapcsolatos információkat tartalmaz. Ehhez a művelethez tanúsítvány-/lekérési/listázási engedély szükséges. Ez a művelet csak helyreállítható törlést engedélyező tárolókon engedélyezhető.

Példahasználat:

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);
  }
}

Törölt tanúsítványok listái

function listDeletedCertificates(options?: ListDeletedCertificatesOptions): PagedAsyncIterableIterator<DeletedCertificate, DeletedCertificate[], PageSettings>

Paraméterek

options
ListDeletedCertificatesOptions

A választható paraméterek

Válaszok

PagedAsyncIterableIterator<DeletedCertificate, DeletedCertificate[], PageSettings>

listPropertiesOfCertificates(ListPropertiesOfCertificatesOptions)

Iterálja a tárolóban található összes tanúsítvány legújabb verzióját. A teljes tanúsítványazonosítót és attribútumokat a válaszban adták meg. A rendszer nem ad vissza értékeket a tanúsítványokhoz. Ehhez a művelethez tanúsítvány-/listaengedély szükséges.

Példahasználat:

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);
  }
}

A megadott tanúsítvány összes verziójának listázása.

function listPropertiesOfCertificates(options?: ListPropertiesOfCertificatesOptions): PagedAsyncIterableIterator<CertificateProperties, CertificateProperties[], PageSettings>

Paraméterek

options
ListPropertiesOfCertificatesOptions

A választható paraméterek

Válaszok

PagedAsyncIterableIterator<CertificateProperties, CertificateProperties[], PageSettings>

listPropertiesOfCertificateVersions(string, OperationOptions)

A megadott kulcstartóban lévő tanúsítvány verzióit adja vissza. Ehhez a művelethez tanúsítvány-/listaengedély szükséges.

Példahasználat:

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

A tanúsítványok verzióinak listázása.

function listPropertiesOfCertificateVersions(certificateName: string, options?: OperationOptions): PagedAsyncIterableIterator<CertificateProperties, CertificateProperties[], PageSettings>

Paraméterek

certificateName

string

A tanúsítvány neve.

options
OperationOptions

A választható paraméterek

Válaszok

PagedAsyncIterableIterator<CertificateProperties, CertificateProperties[], PageSettings>

listPropertiesOfIssuers(OperationOptions)

A tanúsítványkibocsátó erőforrásainak készletét adja vissza a megadott kulcstartóban. Ehhez a művelethez tanúsítványok/manageissuers/getissuers engedély szükséges.

Példahasználat:

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);
  }
}

Sorolja fel a tanúsítványkiállítókat.

function listPropertiesOfIssuers(options?: OperationOptions): PagedAsyncIterableIterator<IssuerProperties, IssuerProperties[], PageSettings>

Paraméterek

options
OperationOptions

A választható paraméterek

Válaszok

PagedAsyncIterableIterator<IssuerProperties, IssuerProperties[], PageSettings>

mergeCertificate(string, Uint8Array[], OperationOptions)

Egy tanúsítvány- vagy tanúsítványlánc egyesítését hajtja végre a szolgáltatásban jelenleg elérhető kulcspárral. Ehhez a művelethez a tanúsítványokra/létrehozásra vonatkozó engedély szükséges.

Példahasználat:

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)]);

Aláírt tanúsítványkérelmet egyesít függőben lévő tanúsítványsá

function mergeCertificate(certificateName: string, x509Certificates: Uint8Array[], options?: OperationOptions): Promise<KeyVaultCertificateWithPolicy>

Paraméterek

certificateName

string

A tanúsítvány neve

x509Certificates

Uint8Array[]

Az egyesítendő tanúsítvány(ok)

options
OperationOptions

A választható paraméterek

Válaszok

Promise<KeyVaultCertificateWithPolicy>

purgeDeletedCertificate(string, OperationOptions)

A megadott tanúsítvány visszafordíthatatlan törlését hajtja végre, helyreállítás lehetősége nélkül. A művelet nem érhető el, ha a helyreállítási szint nem adja meg a "Kiüríthető" értéket. Ehhez a művelethez tanúsítvány-/véglegesítési engedély szükséges.

Példahasználat:

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");

Törölt tanúsítvány lekérhető

function purgeDeletedCertificate(certificateName: string, options?: OperationOptions): Promise<null>

Paraméterek

certificateName

string

A törölni kívánt törölt tanúsítvány neve

options
OperationOptions

A választható paraméterek

Válaszok

Promise<null>

restoreCertificateBackup(Uint8Array, OperationOptions)

Visszaállít egy biztonsági másolatban szereplő tanúsítványt és annak összes verzióját egy tárolóba. Ehhez a művelethez tanúsítványokra/visszaállítási engedélyre van szükség.

Példahasználat:

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!);

Tanúsítvány visszaállítása biztonsági másolatból

function restoreCertificateBackup(backup: Uint8Array, options?: OperationOptions): Promise<KeyVaultCertificateWithPolicy>

Paraméterek

backup

Uint8Array

A biztonsági mentési tanúsítvány, amelyről vissza szeretne állítani

options
OperationOptions

A választható paraméterek

Válaszok

Promise<KeyVaultCertificateWithPolicy>

setContacts(CertificateContact[], OperationOptions)

Beállítja a kulcstartóhoz tartozó tanúsítvány névjegyeit. Ehhez a művelethez tanúsítvány/managecontacts engedély szükséges.

Példahasználat:

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

Beállítja a tanúsítvány névjegyeit.

function setContacts(contacts: CertificateContact[], options?: OperationOptions): Promise<undefined | CertificateContact[]>

Paraméterek

contacts

CertificateContact[]

A használni kívánt névjegyek

options
OperationOptions

A választható paraméterek

Válaszok

Promise<undefined | CertificateContact[]>

updateCertificatePolicy(string, CertificatePolicy, OperationOptions)

Frissítések a megadott tanúsítvány tanúsítványszabályzatát. Ehhez a művelethez tanúsítványokra/frissítési engedélyre van szükség. Tanúsítvány szabályzatának lekérve

function updateCertificatePolicy(certificateName: string, policy: CertificatePolicy, options?: OperationOptions): Promise<CertificatePolicy>

Paraméterek

certificateName

string

A tanúsítvány neve

policy
CertificatePolicy

A tanúsítványházirend

options
OperationOptions

A választható paraméterek

Válaszok

Promise<CertificatePolicy>

updateCertificateProperties(string, string, UpdateCertificateOptions)

A megadott frissítést alkalmazza a megadott tanúsítványra; az egyetlen frissített elem a tanúsítvány attribútumai. Ehhez a művelethez tanúsítványokra/frissítési engedélyre van szükség.

Példahasználat:

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

// You may pass an empty string for version which will update
// the latest version of the certificate
await client.updateCertificateProperties("MyCertificate", "", {
  tags: {
    customTag: "value"
  }
});

tanúsítvány Frissítések

function updateCertificateProperties(certificateName: string, version: string, options?: UpdateCertificateOptions): Promise<KeyVaultCertificate>

Paraméterek

certificateName

string

A tanúsítvány neve

version

string

A frissíteni kívánt tanúsítvány verziója (egy üres sztring frissíti a legújabb verziót)

options
UpdateCertificateOptions

A beállítások, beleértve a frissítendő lehetőségeket

Válaszok

Promise<KeyVaultCertificate>

updateIssuer(string, UpdateIssuerOptions)

Az updateIssuer művelet egy frissítést hajt végre a megadott tanúsítványkibocsátó entitáson. Ehhez a művelethez tanúsítvány/setissuers engedély szükséges.

Példahasználat:

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

Frissítések a megadott tanúsítványkibocsátó.

function updateIssuer(issuerName: string, options?: UpdateIssuerOptions): Promise<CertificateIssuer>

Paraméterek

issuerName

string

A kibocsátó neve.

options
UpdateIssuerOptions

A választható paraméterek

Válaszok

Promise<CertificateIssuer>