Compartilhar via


@azure/keyvault-certificates package

Classes

CertificateClient

O cliente para interagir com a funcionalidade de certificados KeyVault

Interfaces

AdministratorContact

Detalhes do administrador da organização do emissor do certificado.

BackupCertificateResult

O resultado do certificado de backup, que contém o blob de backup.

BeginCreateCertificateOptions

Uma interface que representa os parâmetros opcionais que podem ser passados para <xref:beginCreateCertificate>

CertificateClientOptions

Os parâmetros opcionais aceitos pelo KeyClient do KeyVault

CertificateContactAll

A forma das informações de contato para os certificados do cofre.

CertificateIssuer

Uma interface que representa as propriedades de um emissor.

CertificateOperation

Uma operação de certificado é retornada no caso de solicitações assíncronas.

CertificateOperationError

O erro do servidor do cofre de chaves.

CertificateOperationState

Uma interface que representa as propriedades disponíveis publicamente do estado do CertificateOperationPoller.

CertificatePolicyProperties

Uma interface que representa a política de um certificado (sem as propriedades do assunto).

CertificatePollerOptions

Uma interface que representa os parâmetros opcionais que podem ser passados para <xref:beginCreateCertificate>, <xref:beginDeleteCertificate> e <xref:beginRecoverDeletedCertificate>

CertificateProperties

Uma interface que representa as propriedades de um certificado

CoreSubjectAlternativeNames

Os nomes alternativos de assunto de um objeto X509.

CreateCertificateOptions

Opções para <xref:createCertificate>.

CreateIssuerOptions

Opções para <xref:createIssuer>.

DeletedCertificate

Uma interface que representa um certificado excluído.

ErrorModel

O modelo de erro do servidor do cofre de chaves.

ImportCertificateOptions

Opções para <xref:importCertificate>.

IssuerAttributes

Os atributos de um emissor gerenciado pelo serviço do Key Vault.

IssuerCredentials

As credenciais a serem usadas para o emissor do certificado.

IssuerParameters

Parâmetros para o emissor do componente X509 de um certificado.

IssuerProperties

Uma interface que representa as propriedades de um emissor de certificado

KeyVaultCertificate

Uma interface que representa um certificado sem a política do certificado

KeyVaultCertificateIdentifier

Representa os segmentos que compõem uma ID de certificado do Key Vault.

KeyVaultCertificatePollOperationState

Uma interface que representa a forma pública do estado das operações do Key Vault Certificate Poller.

KeyVaultCertificateWithPolicy

Uma interface que representa um certificado com sua política

LifetimeAction

Ação e seu gatilho que serão executados pelo Key Vault ao longo do tempo de vida de um certificado.

ListDeletedCertificatesOptions

Uma interface que representa parâmetros opcionais para operações de página certificateClient passadas para <xref:listDeletedCertificates>.

ListPropertiesOfCertificatesOptions

Uma interface que representa parâmetros opcionais para operações de página certificateClient passadas para <xref:listPropertiesOfCertificates>.

PolicySubjectProperties

Uma interface que representa as possíveis propriedades do assunto da política de um certificado. O tipo final requer que pelo menos uma dessas propriedades exista.

SubjectAlternativeNamesAll

Uma interface que representa os nomes alternativos do assunto de uma política de certificado.

UpdateCertificateOptions

Opções para <xref:updateCertificate>.

UpdateIssuerOptions

Opções para <xref:updateIssuer>.

X509CertificateProperties

Propriedades do componente X509 de um certificado.

Aliases de tipo

ActionType

Define valores para ActionType.

ArrayOneOrMore

Uma matriz com uma propriedade no mínimo.

BackupCertificateOptions

Opções para <xref:backupCertificate>.

BeginDeleteCertificateOptions

Uma interface que representa os parâmetros opcionais que podem ser passados para <xref:beginDeleteCertificate>

BeginRecoverDeletedCertificateOptions

Uma interface que representa os parâmetros opcionais que podem ser passados para <xref:beginRecoverDeletedCertificate>

CancelCertificateOperationOptions

Opções para <xref:cancelCertificateOperation>.

CertificateContact

As informações de contato dos certificados do cofre. Cada contato terá pelo menos apenas uma das propriedades de CertificateContactAll, que são: emailAddress, nome ou telefone.

CertificateContentType

Define valores para contentType. Os valores possíveis incluem: 'application/x-pem-file', 'application/x-pkcs12'

CertificateKeyCurveName

Define valores para JsonWebKeyCurveName.
<xref:KnownJsonWebKeyCurveName> pode ser usado de forma intercambiável com JsonWebKeyCurveName, essa enumeração contém os valores conhecidos aos quais o serviço dá suporte.

Conhecer valores compatíveis com o serviço

P-256
P-384
P-521
P-256K

CertificateKeyType

Define valores para JsonWebKeyType.
<xref:KnownJsonWebKeyType> pode ser usado de forma intercambiável com JsonWebKeyType, essa enumeração contém os valores conhecidos aos quais o serviço dá suporte.

Conhecer valores compatíveis com o serviço

de EC
EC-HSM
RSA
RSA-HSM
de outubro
oct-HSM

CertificatePolicy

Um tipo que representa a política de um certificado com pelo menos uma das propriedades da entidade.

CertificatePolicyAction

A ação que será executada.

CertificateTags

Uma interface que representa a forma das Marcas de Certificado. As marcas são apenas pares chave-valor de cadeia de caracteres.

CreateCertificateState

A representação pública do estado da operação CreateCertificatePoller.

DeleteCertificateOperationOptions

Opções para <xref:deleteCertificateOperation>.

DeleteCertificateState

A representação pública do estado da operação DeleteCertificatePoller.

DeleteContactsOptions

Opções para <xref:deleteContacts>.

DeleteIssuerOptions

Opções para <xref:deleteIssuer>.

DeletionRecoveryLevel

Define valores para DeletionRecoveryLevel.
<xref:KnownDeletionRecoveryLevel> pode ser usado de forma intercambiável com DeletionRecoveryLevel, essa enumeração contém os valores conhecidos aos quais o serviço dá suporte.

Conhecer valores compatíveis com o serviço

purgável: denota um estado de cofre no qual a exclusão é uma operação irreversível, sem a possibilidade de recuperação. Esse nível corresponde a nenhuma proteção disponível em uma operação Delete; os dados são irremediavelmente perdidos ao aceitar uma operação Delete no nível de entidade ou superior (cofre, grupo de recursos, assinatura etc.)
Recuperável+Purgável: denota um estado do cofre no qual a exclusão é recuperável e que também permite a exclusão imediata e permanente (ou seja, limpeza). Esse nível garante a capacidade de recuperação da entidade excluída durante o intervalo de retenção (90 dias), a menos que uma operação de limpeza seja solicitada ou a assinatura seja cancelada. O sistema o excluirá permanentemente após 90 dias, se não for recuperado
recuperável: denota um estado de cofre no qual a exclusão é recuperável sem a possibilidade de exclusão imediata e permanente (ou seja, limpeza). Esse nível garante a capacidade de recuperação da entidade excluída durante o intervalo de retenção (90 dias) e enquanto a assinatura ainda estiver disponível. O sistema o excluirá permanentemente após 90 dias, se não for recuperado
Recoverable+ProtectedSubscription: denota um cofre e um estado de assinatura no qual a exclusão é recuperável dentro do intervalo de retenção (90 dias), a exclusão imediata e permanente (ou seja, limpeza) não é permitida e na qual a assinatura em si não pode ser cancelada permanentemente. O sistema o excluirá permanentemente após 90 dias, se não for recuperado
CustomedRecoverable+Purgeable: denota um estado de cofre no qual a exclusão é recuperável e que também permite a exclusão imediata e permanente (ou seja, limpeza quando 7<= SoftDeleteRetentionInDays < 90). Esse nível garante a capacidade de recuperação da entidade excluída durante o intervalo de retenção, a menos que uma operação de limpeza seja solicitada ou a assinatura seja cancelada.
CustomizedRecoverable: denota um estado de cofre no qual a exclusão é recuperável sem a possibilidade de exclusão imediata e permanente (ou seja, limpeza quando 7<= SoftDeleteRetentionInDays < 90). Esse nível garante a capacidade de recuperação da entidade excluída durante o intervalo de retenção e enquanto a assinatura ainda estiver disponível.
CustomedRecoverable+ProtectedSubscription: denota um cofre e um estado de assinatura no qual a exclusão é recuperável, a exclusão imediata e permanente (ou seja, limpeza) não é permitida e na qual a assinatura em si não pode ser cancelada permanentemente quando 7<= SoftDeleteRetentionInDays < 90. Esse nível garante a capacidade de recuperação da entidade excluída durante o intervalo de retenção e também reflete o fato de que a própria assinatura não pode ser cancelada.

GetCertificateOperationOptions

Opções para <xref:getCertificateOperation>.

GetCertificateOptions

Opções para <xref:getCertificate>.

GetCertificatePolicyOptions

Opções para <xref:getCertificatePolicy>.

GetCertificateVersionOptions

Opções para <xref:getCertificateVersion>.

GetContactsOptions

Opções para <xref:getContacts>.

GetDeletedCertificateOptions

Opções para <xref:getDeletedCertificate>.

GetIssuerOptions

Opções para <xref:getIssuer>.

GetPlainCertificateOperationOptions

Opções para <xref:getPlainCertificateOperation>.

ImportCertificatePolicy

Um tipo que representa a política de um certificado para importação que não exige uma SAN ou um Assunto

KVPollerLike

Cópia preterida do KeyVault do PollerLike do core-lro.

KeyUsageType

Define valores para KeyUsageType.
<xref:KnownKeyUsageType> pode ser usado de forma intercambiável com KeyUsageType, essa enumeração contém os valores conhecidos aos quais o serviço dá suporte.

Conhecer valores compatíveis com o serviço

digitalSignature
de nãorepudiação
keyEncipherment
dataEncipherment
keyAgreement
keyCertSign
cRLSign
encipherOnly
decipherOnly

ListPropertiesOfCertificateVersionsOptions

Uma interface que representa parâmetros opcionais para operações de página certificateClient passadas para <xref:listPropertiesOfCertificateVersions>.

ListPropertiesOfIssuersOptions

Uma interface que representa parâmetros opcionais para operações de página certificateClient passadas para <xref:listPropertiesOfIssuers>.

MergeCertificateOptions

Uma interface que representa parâmetros opcionais para <xref:mergeCertificate>.

PurgeDeletedCertificateOptions

Opções para <xref:purgeDeletedCertificate>.

RecoverDeletedCertificateState

Preterido: representação pública da recuperação de uma operação de sondagem de certificado excluído

RequireAtLeastOne

RequireAtLeastOne ajuda a criar um tipo em que pelo menos uma das propriedades de uma interface (pode ser qualquer propriedade) é necessária para existir. Isso funciona devido aos tipos de utilitário do TypeScript: https://www.typescriptlang.org/docs/handbook/utility-types.html Vamos examiná-lo:

  • [K in keyof T]-? essa propriedade (K) só será válida se tiver o mesmo nome que qualquer propriedade de T.
  • Required<Pick<T, K>> faz um novo tipo de T com apenas a propriedade atual na iteração e marca-o como necessário
  • Partial<Pick<T, Exclude<keyof T, K>>> faz um novo tipo com todas as propriedades de T, exceto da propriedade K.
  • & é o que une o tipo com apenas uma propriedade necessária de Required<...> com todas as propriedades opcionais de Partial<...>.
  • [keyof T] garante que somente as propriedades de T sejam permitidas.
RestoreCertificateBackupOptions

Uma interface que representa parâmetros opcionais para <xref:restoreCertificateBackup>.

SetContactsOptions

Opções para <xref:setContacts>.

SubjectAlternativeNames

Alternativas à propriedade do assunto. Se estiver presente, ele deverá ter pelo menos uma das propriedades de SubjectAlternativeNamesAll.

UpdateCertificatePolicyOptions

Opções para <xref:updateCertificatePolicy>.

Enumerações

KnownCertificateKeyCurveNames

Valores conhecidos de <xref:JsonWebKeyCurveName> que o serviço aceita.

KnownCertificateKeyTypes

Valores conhecidos de <xref:JsonWebKeyType> que o serviço aceita.

KnownDeletionRecoveryLevels

Valores conhecidos de <xref:DeletionRecoveryLevel> que o serviço aceita.

KnownKeyUsageTypes

Valores conhecidos de <xref:KeyUsageType> que o serviço aceita.

WellKnownIssuer

Emissores conhecidos para escolher um padrão

Funções

parseKeyVaultCertificateIdentifier(string)

Analisa a ID do certificado do Key Vault fornecida. Um exemplo é: https://< keyvault-name.vault.azure.net/certificates/>< certificate-name>/<unique-version-id>

Ao analisar a ID acima, essa função retorna:

  {
     sourceId: "https://<keyvault-name>.vault.azure.net/certificates/<certificate-name>/<unique-version-id>",
     vaultUrl: "https://<keyvault-name>.vault.azure.net",
     version: "<unique-version-id>",
     name: "<certificate-name>"
  }

Detalhes da função

parseKeyVaultCertificateIdentifier(string)

Analisa a ID do certificado do Key Vault fornecida. Um exemplo é: https://< keyvault-name.vault.azure.net/certificates/>< certificate-name>/<unique-version-id>

Ao analisar a ID acima, essa função retorna:

  {
     sourceId: "https://<keyvault-name>.vault.azure.net/certificates/<certificate-name>/<unique-version-id>",
     vaultUrl: "https://<keyvault-name>.vault.azure.net",
     version: "<unique-version-id>",
     name: "<certificate-name>"
  }
function parseKeyVaultCertificateIdentifier(id: string)

Parâmetros

id

string

A ID do Certificado do Key Vault.

Retornos