FortiOS User Device

7 min

Resumo

Este módulo é capaz de configurar um dispositivo FortiGate ou FortiOS (FOS), permitindo ao usuário definir e modificar as características do usuário e a categoria do dispositivo. Os exemplos incluem todos os parâmetros e valores que precisam ser ajustados às fontes de dados antes do uso.

Parâmetros

Parâmetro	Tipo	Escolhas \| Valor Padrão	Comentários
access_token	string		Autenticação baseada em token. Gerado a partir da GUI do Fortigate.
enable_log	boolean	Escolhas: - false(default) - true	Habilite / desabilite o registro da tarefa.
state - required	string	Escolhas: - present - absent	Indica se deve criar ou remover o objeto.
user_device	dictionary		Configure os dispositivos.
vdom	string	Default: "root"	Domínio virtual, entre os definidos anteriormente. A vdom é uma instância virtual do FortiGate que pode ser configurada e usada como uma unidade diferente.

Subcampos da opção user_device

Parâmetro	Tipo	Escolhas \| Valor Padrão	Comentários
alias - required	string		Apelido do dispositivo
avatar	string		Arquivo de imagem para avatar (máximo codificado em 4K base64).
category	string	Escolhas: - none - amazon-device - android-device - blackberry-device - fortinet-device - ios-device - windows-device	Categoria do dispositivo.
comment	string		Comentário
mac	string		Endereço MAC do dispositivo.
master_device	string		Dispositivo mestre (opcional).
tagging	lista / elementos = string		Marcação de objetos de configuração.
type	string	Escolhas: - unknown - android-phone - android-tablet - blackberry-phone - blackberry-playbook - forticam - fortifone - fortinet-device - gaming-console - ip-phone - ipad - iphone - linux-pc - mac - media-streaming - printer - router-nat-device - windows-pc - windows-phone - windows-tablet - other-network-device	Tipo de dispositivo.
user	string		Nome do usuário.

Subcampos da opção tagging

Parâmetro	Tipo	Comentários
category	string	Categoria da tag.
name - required	string	Nome da entrada de marcação.
tags	lista / elementos = stringTag.	Tag.

Subcampos da opção tags

Parâmetro	Tipo	Escolhas \| Valor Padrão	Comentários
name - required	string		Nome da tag.

Extende fragmentos da documentação dos módulos FortiOS e FotiOS API.

Exemplos

- hosts: localhost
  vars:
   host: "192.168.122.40"
   username: "admin"
   password: ""
   vdom: "root"
   ssl_verify: "False"
  tasks:
  - name: Configure devices.
    fortios_user_device:
      host:  "{{ host }}"
      username: "{{ username }}"
      password: "{{ password }}"
      vdom:  "{{ vdom }}"
      https: "False"
      state: "present"
      user_device:
        alias: "<your_own_value>"
        avatar: "<your_own_value>"
        category: "none"
        comment: "Comment."
        mac: "<your_own_value>"
        master_device: "<your_own_value> (source user.device.alias)"
        tagging:
         -
            category: "<your_own_value> (source system.object-tagging.category)"
            name: "default_name_11"
            tags:
             -
                name: "default_name_13 (source system.object-tagging.tags.name)"
        type: "unknown"
        user: "<your_own_value>"

Valores Retornados

Chave	Tipo	Retornado quando	Descrição
build	string	sempre	Número de construção da imagem fortificada
http_method	string	sempre	Último método usado para provisionar o conteúdo no FortiGate
http_status	string	sempre	Último resultado dado por FortiGate na última operação aplicada
mkey	string	sucesso	Chave mestra (id) usada na última chamada para FortiGate
name	string	sempre	Nome da mesa usada para atender ao pedido
path	string	sempre	Caminho da mesa usada para atender ao pedido
revision	string	sempre	Número de revisão interna
serial	string	sempre	Número de série da unidade
status	string	sempre	Indicação do resultado da operação
vdom	string	sempre	Domínio virtual usado
version	string	sempre	Versão do FortiGate