Objetos de resposta

Este documento descreve os tipos de objeto que a API de administração retorna no campo ResultData da resposta.

UserView

Retornado por métodos que listam ou recuperam informações de usuários, como ListUsersInDomain.

Campo	Tipo	Descrição
uid	string	Identificador único do usuário no formato USER:<id>@<domínio>.
userHandler	integer	ID interno do usuário.
username	string	Nome de usuário.
friendlyName	string	Nome completo do usuário.
domain	string	Alias do domínio ao qual o usuário pertence.
email	string	Endereço de e-mail do usuário.
type	string	Tipo de usuário. Valores: LOCAL_USER, CERTIFICATE_USER, ACTIVE_DIRECTORY, LDAP, SAML2, OAuth2, ACTIVATION_CODE, UNKNOWN.
groupType	string	Indica se a entidade é um usuário ou um grupo. Valores: USER, GROUP.
status	boolean	true se o usuário está ativo.
consumeLicense	boolean	true se o usuário consumiu uma licença.
lastCertificateUsage	datetime	Última vez que o usuário usou um certificado. null se nunca usou.
passwordExpirationDate	datetime	Data de expiração da senha. null se não estiver configurada.

DomainView

Retornado por métodos que listam domínios, como ListDomains.

Campo	Tipo	Descrição
id	integer	ID do domínio.
alias	string	Alias do domínio.
allowPersonalArea	boolean	true se os usuários do domínio podem acessar a área pessoal.
webSignatureAccess	boolean	true se os usuários do domínio podem usar o módulo Signtrust.
allowUploadCerts	boolean	true se os usuários do domínio podem fazer upload de certificados pessoais.
schema	string	Tipo de domínio. Mesmos valores que UserView.type.
allowedUsers	integer	Número máximo de usuários permitidos. 0 significa sem limite.
numUsers	integer	Número atual de usuários no domínio.
isExternal	boolean	true se o domínio é externo.
sharepointAccess	boolean	true se os usuários do domínio podem usar o módulo do SharePoint.

CertificateView

Retornado por ListCertificates. Contém as informações principais de um certificado.

Campo	Tipo	Descrição
certificateHandler	integer	ID do certificado.
name	string	Alias do certificado.
active	boolean	true se o certificado está ativo.
groups	array de strings	Nomes dos grupos de certificados que contêm este certificado.
policies	array de strings	Nomes das políticas que usam este certificado.
users	array de strings	Usuários associados ao certificado.
user_groups	array de strings	Grupos de usuários associados ao certificado.
issuer	string	Emissor do certificado.
subject	string	Sujeito do certificado.
creationDate	datetime	Data em que o certificado foi adicionado ao Redtrust.
expirationDate	datetime	Data de expiração do certificado.
expired	boolean	true se o certificado expirou.
times_used	integer	Número de vezes que o certificado foi usado.
datetime_last_usage	datetime	Data do último uso do certificado. null se nunca foi usado.
needPin	boolean	true se o uso do certificado requer um PIN.
externalId	string	Identificador externo do certificado.
assignable	boolean	true se o proprietário do certificado pode ser alterado.
owner	string	Nome de usuário do proprietário do certificado.
ownerId	integer	ID do proprietário do certificado.
ownerUID	string	UID do proprietário do certificado.
usageReason	boolean	true se o uso do certificado requer informar um motivo.
userPinPolicy	string	Comportamento do PIN do usuário em relação ao certificado.
allowBackup	boolean	true se o certificado pode ser baixado do Redtrust.
allowCSR	boolean	true se é possível criar uma CSR a partir deste certificado.
isRevoked	boolean	true se o certificado está revogado.
policyIdentifier	string	Identificador do perfil do certificado.

CertificateDetail

Retornado por GetCertificateData. Inclui todos os campos de CertificateView mais os detalhes completos do certificado X.509.

Campo	Tipo	Descrição
certificateHandler	integer	ID do certificado.
active	boolean	true se o certificado está ativo.
alias	string	Alias do certificado.
friendlyName	string	Nome amigável do certificado.
certificateSN	string	Número de série do certificado.
thumbprint	string	Impressão digital do certificado.
subject	string	Sujeito do certificado (DN completo).
issuer	string	Emissor do certificado (DN completo).
validFrom	datetime	Início do período de validade do certificado.
validUntil	datetime	Fim do período de validade do certificado.
expired	boolean	true se o certificado expirou.
notEnabledYet	boolean	true se a data de início de validade ainda não foi atingida.
version	integer	Versão do certificado X.509.
signatureAlg	string	Algoritmo de assinatura do certificado.
keyValue	string	Valor da chave pública do certificado.
extensions	string	Extensões do certificado.
archived	boolean	true se o certificado está arquivado.
comment	string	Comentário livre sobre o certificado.
needPin	boolean	true se o uso do certificado requer um PIN.
usageReason	boolean	true se o uso do certificado requer informar um motivo.
userPinPolicy	string	Comportamento do PIN do usuário em relação ao certificado.
assignable	boolean	true se o proprietário do certificado pode ser alterado.
owner	string	Nome de usuário do proprietário do certificado.
ownerId	integer	ID do proprietário do certificado.
ownerUID	string	UID do proprietário do certificado.
ownerName	string	Nome completo do proprietário do certificado.
groups	array de strings	Grupos de certificados que contêm este certificado.
policies	array de strings	Políticas que usam este certificado.
users	array de strings	Usuários associados ao certificado.
user_groups	array de strings	Grupos de usuários associados ao certificado.
timesUsed	integer	Número de vezes que o certificado foi usado.
datetimeLastUsage	datetime	Data do último uso do certificado. null se nunca foi usado.
subjectSimpleName	string	Nome simples do sujeito.
subjectDnsName	string	Nome DNS do sujeito.
subjectDnsFromAlternativeName	string	Nome DNS do sujeito obtido da extensão de nome alternativo.
subjectEmailName	string	Endereço de e-mail do sujeito.
subjectUpnName	string	UPN do sujeito.
subjectUrlName	string	URL associada ao sujeito.
issuerSimpleName	string	Nome simples do emissor.
issuerDnsName	string	Nome DNS do emissor.
issuerDnsFromAlternativeName	string	Nome DNS do emissor obtido da extensão de nome alternativo.
issuerEmailName	string	Endereço de e-mail do emissor.
issuerUpnName	string	UPN do emissor.
issuerUrlName	string	URL associada ao emissor.

CACertificateView

Retornado por ListCACertificates.

Campo	Tipo	Descrição
id	integer	ID do certificado CA.
issuer	string	Emissor do certificado CA.
subject	string	Sujeito do certificado CA.
expirationDate	datetime	Data de expiração do certificado CA.
creationDate	datetime	Data a partir da qual o certificado CA é válido.
expired	boolean	true se o certificado CA expirou.
installed	boolean	true se o certificado CA está instalado no Redtrust.
thumbprint	string	Impressão digital do certificado CA.

CertificateAttribute

Retornado por ListCertificateAttributes. Representa um tipo de atributo de certificado disponível no sistema.

Campo	Tipo	Descrição
id	integer	ID do atributo de certificado. Use este valor no campo id de certAttributes ao chamar AddCertificateUser.
name	string	Nome do atributo de certificado.

CertificateDirective

Retornado por ListCertificateDirectives. Representa uma diretiva de certificado configurada no sistema.

Campo	Tipo	Descrição
id	integer	ID da diretiva de certificado. Use este valor em certDirectiveIds ao chamar AddCertificateUser.
value	string	Descrição ou valor da diretiva de certificado.