Partilhar 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, contendo o blob de backup.

BeginCreateCertificateOptions

Uma interface que representa os parâmetros opcionais que podem ser passados para beginCreateCertificate(string, CertificatePolicy, BeginCreateCertificateOptions)

CertificateClientOptions

Os parâmetros opcionais aceitos pelo CertificateClient do KeyVault

CertificateContactAll

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

CertificateIssuer

Uma interface que representa as propriedades de um emissor.

CertificateOperation

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

CertificateOperationError

O erro do servidor do cofre de chaves.

CertificateOperationState

Uma interface que representa as propriedades publicamente disponíveis 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 beginCreateCertificate(string, CertificatePolicy, BeginCreateCertificateOptions), beginDeleteCertificate(string, CertificatePollerOptions) e beginRecoverDeletedCertificate(string, CertificatePollerOptions)

CertificateProperties

Uma interface que representa as propriedades de um certificado

CoreSubjectAlternativeNames

O assunto alterna nomes de um objeto X509.

CreateCertificateOptions

Opções para <xref:createCertificate>.

CreateIssuerOptions

Opções para createIssuer(string, string, CreateIssuerOptions).

DeletedCertificate

Uma interface que representa um certificado excluído.

ErrorModel

O modelo de erro do servidor do cofre de chaves.

ImportCertificateOptions

Opções para importCertificate(string, Uint8Array, ImportCertificateOptions).

IssuerAttributes

Os atributos de um emissor gerenciado pelo serviço Cofre de Chaves.

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 Cofre da Chave.

KeyVaultCertificatePollOperationState

Uma interface que representa a forma pública do estado das operações de um Poller de Certificados do Cofre de Chaves.

KeyVaultCertificateWithPolicy

Uma interface que representa um certificado com sua política

LifetimeAction

Ação e seu gatilho que será executado pelo Key Vault ao longo da vida útil de um certificado.

ListDeletedCertificatesOptions

Uma interface que representa parâmetros opcionais para operações paginadas CertificateClient passadas para listDeletedCertificates(ListDeletedCertificatesOptions).

ListPropertiesOfCertificatesOptions

Uma interface que representa parâmetros opcionais para operações paginadas CertificateClient passadas para listPropertiesOfCertificates(ListPropertiesOfCertificatesOptions).

PolicySubjectProperties

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

PollerLike

Representação abstrata de um poller, destinada a expor apenas a API mínima com a qual o usuário precisa trabalhar.

PollerLikeWithCancellation

Representação abstrata de um poller, destinada a expor apenas a API mínima com a qual o usuário precisa trabalhar.

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 updateIssuer(string, UpdateIssuerOptions).

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 backupCertificate(string, OperationOptions).

BeginDeleteCertificateOptions

Uma interface que representa os parâmetros opcionais que podem ser passados para beginDeleteCertificate(string, CertificatePollerOptions)

BeginRecoverDeletedCertificateOptions

Uma interface que representa os parâmetros opcionais que podem ser passados para beginRecoverDeletedCertificate(string, CertificatePollerOptions)

CancelCertificateOperationOptions

Opções para <xref:cancelCertificateOperation>.

CertificateContact

As informações de contato dos certificados do vault. Cada contato terá pelo menos 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, este enum contém os valores conhecidos que o serviço suporta.

Valores conhecidos suportados pelo 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, este enum contém os valores conhecidos que o serviço suporta.

Valores conhecidos suportados pelo serviço

CE
EC-HSM
RSA
RSA-HSM
out
oct-HSM

CertificatePolicy

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

CertificatePolicyAction

A ação que será executada.

CertificateTags

Uma interface que representa a forma das Tags de Certificado. As tags 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 deleteCertificateOperation(string, OperationOptions).

DeleteCertificateState

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

DeleteContactsOptions

Opções para deleteContacts(OperationOptions).

DeleteIssuerOptions

Opções para deleteIssuer(string, OperationOptions).

DeletionRecoveryLevel

Define valores para DeletionRecoveryLevel.
<xref:KnownDeletionRecoveryLevel> pode ser usado de forma intercambiável com DeletionRecoveryLevel, este enum contém os valores conhecidos que o serviço suporta.

Valores conhecidos suportados pelo serviço

Purgeable: Indica um estado vault no qual a exclusão é uma operação irreversível, sem a possibilidade de recuperação. Este nível corresponde a nenhuma proteção disponível contra uma operação Delete; os dados são irremediavelmente perdidos ao aceitar uma operação de Exclusão no nível da entidade ou superior (cofre, grupo de recursos, assinatura, etc.)
Recoverable+Purgeable: Indica um estado vault no qual a exclusão é recuperável e que também permite a exclusão imediata e permanente (ou seja, purga). 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 irá excluí-lo permanentemente após 90 dias, se não for recuperado
recuperável : Indica um estado vault no qual a exclusão é recuperável sem a possibilidade de exclusão imediata e permanente (ou seja, purga). 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 irá excluí-lo permanentemente após 90 dias, se não for recuperado
Recoverable+ProtectedSubscription: indica um estado de cofre e 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 irá excluí-lo permanentemente após 90 dias, se não for recuperado
CustomizedRecoverable+Purgeable: Indica um estado vault no qual a exclusão é recuperável e que também permite a exclusão imediata e permanente (ou seja, purga 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 Purge seja solicitada ou a assinatura seja cancelada.
CustomizedRecoverable: Indica 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.
CustomizedRecoverable+ProtectedSubscription: Indica um estado de cofre e 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 assinatura em si não pode ser cancelada.

GetCertificateOperationOptions

Opções para getCertificateOperation(string, CertificatePollerOptions).

GetCertificateOptions

Opções para getCertificate(string, OperationOptions).

GetCertificatePolicyOptions

Opções para getCertificatePolicy(string, OperationOptions).

GetCertificateVersionOptions

Opções para getCertificateVersion(string, string, OperationOptions).

GetContactsOptions

Opções para getContacts(OperationOptions).

GetDeletedCertificateOptions

Opções para getDeletedCertificate(string, OperationOptions).

GetIssuerOptions

Opções para getIssuer(string, OperationOptions).

GetPlainCertificateOperationOptions

Opções para <xref:getPlainCertificateOperation>.

ImportCertificatePolicy

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

KVPollerLike

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

KeyUsageType

Define valores para KeyUsageType.
<xref:KnownKeyUsageType> pode ser usado de forma intercambiável com KeyUsageType, este enum contém os valores conhecidos que o serviço suporta.

Valores conhecidos suportados pelo serviço

digitalSignature
de não repúdio
keyEncipherment
dataEncipherment
keyAgreement
keyCertSign
cRLSign
encipherOnly
decifrarApenas

ListPropertiesOfCertificateVersionsOptions

Uma interface que representa parâmetros opcionais para operações paginadas CertificateClient passadas para listPropertiesOfCertificateVersions(string, OperationOptions).

ListPropertiesOfIssuersOptions

Uma interface que representa parâmetros opcionais para operações paginadas CertificateClient passadas para listPropertiesOfIssuers(OperationOptions).

MergeCertificateOptions

Uma interface que representa parâmetros opcionais para mergeCertificate(string, Uint8Array[], OperationOptions).

PurgeDeletedCertificateOptions

Opções para purgeDeletedCertificate(string, OperationOptions).

RecoverDeletedCertificateState

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

RequireAtLeastOne

RequireAtLeastOne ajuda a criar um tipo onde pelo menos uma das propriedades de uma interface (pode ser qualquer propriedade) é necessária para existir.

Isso funciona devido aos tipos de utilidade do TypeScript: https://www.typescriptlang.org/docs/handbook/utility-types.html Vamos examiná-lo:

  • [K in keyof T]-? esta propriedade (K) só é válida se tiver o mesmo nome que qualquer propriedade de T.
  • Required<Pick<T, K>> cria um novo tipo de T apenas com a propriedade atual na iteração e a marca conforme 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 apenas as propriedades de T sejam permitidas.
RestoreCertificateBackupOptions

Uma interface que representa parâmetros opcionais para restoreCertificateBackup(Uint8Array, OperationOptions).

SetContactsOptions

Opções para setContacts(CertificateContact[], OperationOptions).

SubjectAlternativeNames

Alternativas à propriedade do sujeito. Se presente, ele deve ter pelo menos uma das propriedades de SubjectAlternativeNamesAll.

UpdateCertificatePolicyOptions

Opções para updateCertificatePolicy(string, CertificatePolicy, OperationOptions).

Enumerações

KnownCertificateKeyCurveNames

Os valores conhecidos de CertificateKeyCurveName que o serviço aceita.

KnownCertificateKeyTypes

Os valores conhecidos de CertificateKeyType que o serviço aceita.

KnownDeletionRecoveryLevels

Os valores conhecidos de DeletionRecoveryLevel que o serviço aceita.

KnownKeyUsageTypes

Valores conhecidos de KeyUsageType que o serviço aceita.

WellKnownIssuer

Emissores bem conhecidos para escolher um padrão

Funções

parseKeyVaultCertificateIdentifier(string)

Analisa a ID do certificado do Key Vault fornecida. Um exemplo é:

https://.vault.azure.net/certificates//

Ao analisar o 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 de Função

parseKeyVaultCertificateIdentifier(string)

Analisa a ID do certificado do Key Vault fornecida. Um exemplo é:

https://.vault.azure.net/certificates//

Ao analisar o 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): KeyVaultCertificateIdentifier

Parâmetros

id

string

A ID do certificado do Cofre da Chave.

Devoluções