Cria um ativo na estrutura organizacional.
URL
{RMUrl}/api/Organization/assets
MÉTODO DE SOLICITAÇÃO
POST
PARÂMETROS DA URL
Essa funcionalidade não possui parâmetros.
CONTEÚDO DO FORMULÁRIO
AssetType (obrigatório): tipo do ativo que será criado. Pode ter os valores: Pessoa, Processo, Ambiente e Tecnologia. Em inglês: Person, Process, Environment e Technology.
Name (obrigatório): nome do ativo que será criado. O limite é de 400 caracteres.
Path (opcional caso exista ParentPerimeter): caminho na estrutura organizacional onde o ativo será criado. O limite é de 400 caracteres para cada perímetro do caminho.
ParentPerimeter (opcional caso exista Path): ID do perímetro no qual o ativo será criado.
Responsible (opcional): pessoa responsável pelo ativo que será criado.
Relevance (obrigatório): relevância do ativo que será criado. Valores válidos: números inteiros entre 1 e 5, com 1 (Muito Baixa), 2 (Baixa), 3 (Média), 4 (Alta) e 5 (Muito Alta).
Criticality (opcional): criticidade do ativo que será criado. Valores válidos: números reais positivos de 1 a 100.
AnalysisFrequency (opcional): periodicidade da análise, em dias. Valores válidos: números inteiros positivos. O máximo é de 1.000 dias.
Description (opcional): descrição do ativo que será criado.
Latitude (opcional; obrigatório caso o campo "Longitude" esteja preenchido): latitude da localização do ativo que será criado. Valores válidos: de -90.0 a +90.0. A marcação decimal deve ser representada por um ponto e não por uma vírgula.
Longitude (opcional; obrigatório caso o campo "Latitude" esteja preenchido): longitude da localização do ativo que será criado. Valores válidos: de -180.0 a +180.0. A marcação decimal deve ser representada por um ponto e não por uma vírgula.
GeolocationDescription (opcional): descrição da localização geográfica do ativo que será criado. O limite é de 1.000 caracteres.
ZoomLevel (opcional): nível de zoom no mapa da localização do ativo que será criado. Valores válidos: números inteiros entre 0 e 21.
CustomAttributes (opcional): lista de objetos com informações sobre os atributos de ativos. Cada atributo é referenciado através do nome da variável. Os atributos do tipo Relacionamento podem ser referenciados pelo campo Id, pelo campo Caption (nome que identifica o objeto) ou pelos dois campos. Caso os dois campos sejam fornecidos, eles devem referenciar o mesmo objeto. É recomendado que, sempre que possível, seja dada preferência ao campo Id. Para obter a lista de formatos dos campos Id e Caption, veja o tópico Apêndice 2: Formato de preenchimento dos atributos.
Se o ativo for do tipo Tecnologia, os campos abaixo também podem ser enviados no formulário:
CollectionParameters
HostAddress (opcional): endereço do ativo que será coletado.
Credentials (opcional): credenciais utilizadas para acessar a máquina alvo.
CollectorServer (opcional): servidor de coleta utilizado para gerenciar a coleta.
MappingCriteria
NetbiosName (opcional): nome que será mapeado com o nome NetBIOS identificado por um scanner de vulnerabilidades. Valores válidos: Inherited, Disabled, AssetName, HostAddress ou atributos do tipo Texto criados para ativos tecnológicos.
IPAddress (opcional): endereço IP que será mapeado com o endereço IP identificado por um scanner de vulnerabilidades. Valores válidos: Inherited, Disabled, AssetName, HostAddress ou atributos do tipo Texto criados para ativos tecnológicos.
DNSName (opcional): nome DNS que será mapeado com o nome DNS identificado por um scanner de vulnerabilidades. Valores válidos: Inherited, Disabled, AssetName, HostAddress ou atributos do tipo Texto criados para ativos tecnológicos.
EXEMPLOS DO CONTEÚDO DO FORMULÁRIO
Criar um ativo do tipo Ambiente utilizando o campo Path:
{
"Name":"Ativo 1",
"Path":"API",
"AssetType":"Ambiente"
}
Criar um ativo do tipo Ambiente utilizando o campo ParentPerimeter:
{
"Name": "Ativo 2",
"AssetType":"Ambiente",
"ParentPerimeter": {
"Id": "bc1f6287-6264-4fd7-8b95-db60fae887a3"
}
}
Criar um ativo do tipo Ambiente com um atributo do tipo Relacionamento utilizando o campo Caption:
{
"Name":"Datacenter",
"Path":"Administração de Redes",
"AssetType":"Ambiente",
"Description":"Centro de processamento de dados da empresa",
"Criticality":1.0,
"AnalysisFrequency":30,
"Relevance":5,
"Responsible":{"Name":"Alexandre Ferreira"},
"Latitude":-25.761163,
"Longitude":-33.299314,
"GeolocationDescription":"Matriz da empresa",
"ZoomLevel":15,
"CustomAttributes": {
"atributo_relacionamentosimples_ativo":{
"Caption":"Diretoria > Nome da pessoa"},
"atributo_relacionamentomultiplo_grupo":[{"Caption":"Diretoria"},{"Caption":"Informatica"},{"Caption":"Financeiro"},{"Caption":"Recursos Humanos"}]
}
}
Criar um ativo do tipo Tecnologia com seus campos específicos:
{
"Name":"Notebook do Diretor",
"Path":"Marketing",
"AssetType":"Tecnologia",
"Description":"Notebook do Diretor Alexandre Ferreira",
"Criticality":1.0,
"AnalysisFrequency":30,
"Relevance":5,
"Responsible":{"Name":"Alexandre Ferreira"},
"Latitude":-23.761163,
"Longitude":-53.299314,
"GeolocationDescription":"Matriz da empresa",
"ZoomLevel":15,
"CollectionParameters":
{
"CollectorServer": "Servidor Novo",
"Credentials": "computador do joao",
"HostAddress": " 110.10.1.10"
},
"MappingCriteria":
{
"DnsName": { "Type": "Disabled" },
"IpAddress": { "Type": "AssetName" },
"NetbiosName": { "Type": "Attribute", "AttributeVariableName": "custom_texto_ativo" }
},
"CustomAttributes": {
"atributo_datahora":"\/Date(1320335183486)\/",
"atributo_email":"info@exemplo.com.br",
"atributo_link":"http://www.exemplo.com.br",
"atributo_numero":"999",
"atributo_paragrafo":"Informacao importante",
"atributo_texto":"conteudo do atributo",
"atributo_singleselection":"opcaounica",
"atributo_multipleselection":["opcao1","opcao2"],
"atributo_outline":["opcao1","opcao2"],
"atributo_relacionamentosimples_ativo":{
"Id":"90a849c8-eb27-46e7-9b23-13c6ac26a694"},
"atributo_relacionamentomultiplo_grupo":[{"Caption":"Diretoria"},{"Caption":"Informatica"},{"Caption":"Financeiro"},{"Caption":"Recursos Humanos"}]
}
}
RESPOSTA DE SUCESSO
O código do novo ativo criado. Retorna uma string.