Set Certificate Issuer - Set Certificate Issuer

Serviço:

Key Vault

Versão da API:

7.4

Define o emissor do certificado especificado.
A operação SetCertificateIssuer adiciona ou atualiza o emissor do certificado especificado. Essa operação requer a permissão certificates/setissuers.

PUT {vaultBaseUrl}/certificates/issuers/{issuer-name}?api-version=7.4

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
issuer-name	path	True	string	O nome do emissor. O valor fornecido pode ser copiado globalmente para fins de execução do serviço. O valor fornecido não deve incluir informações pessoais identificáveis ou confidenciais.
vaultBaseUrl	path	True	string	O nome do cofre, por exemplo, https://myvault.vault.azure.net.
api-version	query	True	string	Versão da API do cliente.

Corpo da solicitação

Nome	Obrigatório	Tipo	Description
provider	True	string	O provedor emissor.
attributes		IssuerAttributes	Atributos do objeto emissor.
credentials		IssuerCredentials	As credenciais a serem usadas para o emissor.
org_details		OrganizationDetails	Detalhes da organização, conforme fornecido ao emissor.

Respostas

Nome	Tipo	Description
200 OK	IssuerBundle	O emissor do certificado do cofre de chaves.
Other Status Codes	KeyVaultError	Resposta de erro do Key Vault descrevendo por que a operação falhou.

Exemplos

SetCertificateIssuer

Solicitação de exemplo

HTTP

PUT https://myvault.vault.azure.net//certificates/issuers/issuer01?api-version=7.4

{
  "provider": "Test",
  "credentials": {
    "account_id": "keyvaultuser",
    "pwd": "password"
  },
  "org_details": {
    "admin_details": [
      {
        "first_name": "John",
        "last_name": "Doe",
        "email": "admin@microsoft.com",
        "phone": "4255555555"
      }
    ]
  }
}

Resposta de exemplo

Código de status:

200

{
  "id": "https://myvault.vault.azure.net/certificates/issuers/issuer01",
  "provider": "Test",
  "credentials": {
    "account_id": "keyvaultuser"
  },
  "org_details": {
    "admin_details": [
      {
        "first_name": "John",
        "last_name": "Doe",
        "email": "admin@microsoft.com",
        "phone": "4255555555"
      }
    ]
  },
  "attributes": {
    "enabled": true,
    "created": 1482188806,
    "updated": 1482189526
  }
}

Definições

Nome	Description
AdministratorDetails	Detalhes do administrador da organização do emissor do certificado.
CertificateIssuerSetParameters	Os parâmetros do conjunto de emissores de certificado.
Error	O erro do servidor do cofre de chaves.
IssuerAttributes	Os atributos de um emissor gerenciado pelo serviço do Key Vault.
IssuerBundle	O emissor do certificado do Key Vault.
IssuerCredentials	As credenciais a serem usadas para o emissor do certificado.
KeyVaultError	A exceção de erro do cofre de chaves.
OrganizationDetails	Detalhes da organização do emissor do certificado.

AdministratorDetails

Objeto

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

Nome	Tipo	Description
email	string	Endereço eletrônico.
first_name	string	Nome próprio.
last_name	string	Apelido.
phone	string	Número de telefone.

CertificateIssuerSetParameters

Objeto

Os parâmetros do conjunto de emissores de certificado.

Nome	Tipo	Description
attributes	IssuerAttributes	Atributos do objeto emissor.
credentials	IssuerCredentials	As credenciais a serem usadas para o emissor.
org_details	OrganizationDetails	Detalhes da organização, conforme fornecido ao emissor.
provider	string	O provedor emissor.

Error

Objeto

O erro do servidor do cofre de chaves.

Nome	Tipo	Description
code	string	O código de erro.
innererror	Error	O erro do servidor do cofre de chaves.
message	string	A mensagem de erro.

IssuerAttributes

Objeto

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

Nome	Tipo	Description
created	integer (unixtime)	Hora de criação em UTC.
enabled	boolean	Determina se o emissor está habilitado.
updated	integer (unixtime)	Hora da última atualização em UTC.

IssuerBundle

Objeto

O emissor do certificado do Key Vault.

Nome	Tipo	Description
attributes	IssuerAttributes	Atributos do objeto emissor.
credentials	IssuerCredentials	As credenciais a serem usadas para o emissor.
id	string	Identificador do objeto emissor.
org_details	OrganizationDetails	Detalhes da organização, conforme fornecido ao emissor.
provider	string	O provedor emissor.

IssuerCredentials

Objeto

As credenciais a serem usadas para o emissor do certificado.

Nome	Tipo	Description
account_id	string	O nome de usuário/nome da conta/id da conta.
pwd	string	A chave de senha/segredo/conta.

KeyVaultError

Objeto

A exceção de erro do cofre de chaves.

Nome	Tipo	Description
error	Error	O erro do servidor do cofre de chaves.

OrganizationDetails

Objeto

Detalhes da organização do emissor do certificado.

Nome	Tipo	Description
admin_details	AdministratorDetails[]	Detalhes do administrador da organização.
id	string	ID da organização.