Gerenciamento de ativos no Orchestrator

Crie e gerencie ativos no Orchestrator, incluindo credenciais, valores de texto e outros recursos compartilhados para uso de automação.

Criação de ativos

1. On the Assets page, select Add asset, then select Create a new asset. The Add Asset page is displayed.
2. No campo Asset name, insira um nome para o ativo.
3. In the Description field, enter what the asset is used for.
4. Na lista Tipo, selecione o tipo de ativo que você deseja criar.
   • For credential or secret assets, from the Credential Store list, select where the asset is stored.
   • For Object (define properties) assets, in the Schema section, select Add property to define the properties of the object.
5. To let external apps and integrations read the asset value through the Orchestrator API, turn on Expose value to API. Automations can always read the asset.
6. In the Global value & overrides section, enter the global value in the Global row. All accounts without an override receive this value.
   • To enter the value in a side panel, select Edit global value, enter the value, then select Done.
   • To create the asset without a global value, turn off the toggle in the Global row. In this case, you must add at least one override.
7. To add a value for a specific account or account-machine pair, select Add override. The New override panel is displayed.
   1. Under Applies to, select In current folder to pick a user assigned to the folder, or In identity directory to pick a user from the identity directory.
   2. From the Account list, select the account.
   3. From the Machine list, keep Any machine, or select a specific machine.
   4. Enter the value, then select Done.
8. Select Create asset.

The asset is created and displayed on the Assets page.

Observação:

• Após a criação de um ativo, não é possível alterar o tipo de ativo.
• Se você criar ativos de credenciais de valor global ou de segredos com o mesmo nome do Orchestrator e o mesmo nome externo em várias pastas do Orchestrator, esses ativos apontarão para um único objeto no armazenamento de credenciais. Portanto, qualquer alteração que você faça no ativo em uma das pastas do Orchestrator afeta todos os ativos com nomes idênticos nas outras pastas do Orchestrator. Para evitar alterações acidentais em ativos de credenciais com nomes idênticos ou segredos em pastas do Orchestrator, use um nome externo diferente para o ativo em cada pasta. Isso garante que os ativos apontem para diferentes objetos no armazenamento de credenciais.

Campo	Description
Nome do ativo	Um nome personalizado para que o ativo possa ajudá-lo a identificá-lo facilmente. Não pode exceder 256 caracteres.
Tipo	The type of the asset. The following options are available, grouped as Primitive, Secure, and JSON: Texto : ativos que podem armazenar valores de string. Esse é o valor padrão. Bool : ativos que podem armazenar um valor verdadeiro ou falso. Se você selecionar esta opção, o campo Valor exibe dois botões de opção ( True , False ). Integer: ativos que podem armazenar números inteiros. Credential : ativos que podem armazenar credenciais. Se você selecionar esta opção, o campo Valor será substituído por outros dois: Nome de usuário, que não pode exceder 512 caracteres, e Senha, que não pode exceder 25.000 caracteres. Segredo : ativos que podem armazenar segredos, como chaves de API. Insira o valor do segredo no campo Segredo.O segredo não pode exceder 25.000 caracteres. Observação: você pode usar ativos do tipo secreto apenas em conjunto com agentes codificados, que são indicados como Agente (<idioma de<programming language> programação>) . Nenhum tipo de processo com um pacote subjacente criado pelo Studio suporta atualmente ativos do tipo segredo. JSON : assets that can store structured JSON data. The following JSON types are available: Object (define properties) , Array of strings , Number (Float) , DateTime , Email , URL , Regex , and Any . For Object (define properties) assets, you define the properties of the object in the Schema section.
Expose value to API	Defines whether the asset value can also be read outside automations. Automations can always read the asset. Off: only automations can read the asset value. This is the default option. On: external apps and integrations can also read the asset value through the Orchestrator API.
Armazenamento de Credenciais	Disponível apenas ao adicionar ativos de credencias ou de segredos. O armazenamento de credenciais onde o ativo será salvo, seja o banco de dados do Orchestrator nativo ou qualquer um dos seus armazenamentos externos criados. Observação: você não pode recuperar ativos do tipo segredo de um armazenamento de credenciais externo ao usar um proxy desconectado.
Nome Externo	Disponível apenas ao adicionar ativos de credencial ou secretos a um armazenamento de credenciais. O nome do ativo a ser usado ao se comunicar com o armazenamento de credenciais.
Global value	The value received by all accounts, except those with an override (defined using the Add override button). Enter it in the Global row of the Global value & overrides section, or select Edit global value to enter it in a side panel. To create the asset without a global value, turn off the toggle in the Global row. When the global value is turned on, you must enter the value that is received by accounts: Para os ativos Bool, dois botões de opção, True e False, são exibidos. Por padrão, o False fica marcado. Para ativos de Credencial, os campos Nome de usuário e Senha são habilitados. - É necessário preencher os dois campos. Para ativos secretos, você deve inserir um valor no campo Segredo. Para ativos de texto, este campo permite até 1.000.000 caracteres.
Add override	Permite que você adicione valores de ativos específicos por conta ou por conta-máquina. In the New override panel, select whether the account is In current folder or In identity directory, then select the Account and, optionally, the Machine. When the global value is turned off, you must configure at least one override. If a global value is provided, adding overrides is optional. Para os ativos Bool, dois botões de opção, True e False, são exibidos. Por padrão, o False fica marcado. Para ativos de Credencial, os campos Nome de usuário e Senha são habilitados. - É necessário preencher os dois campos. Para ativos secretos, você deve inserir um valor no campo Segredo. Para ativos de texto, este campo permite até 1.000.000 caracteres.

Gerenciamento de links de ativos

Compartilhar ativos entre pastas habilita o início de trabalhos em várias pastas sem reprojetar seus fluxos de trabalho no Studio quando os processos subjacentes têm como destino o mesmo ativo. Vincular um ativo a uma pasta disponibiliza o ativo e todos os objetos associados a ele, como itens de ativo, nessa pasta.

Importante:

Você só pode compartilhar ativos com valores globais e sem nenhum valor específico por conta. Você não pode compartilhar ativos com valores por conta entre pastas.

Observação:

Um ativo vinculado a várias pastas é marcado usando o ícone .Se o ícone não estiver presente, então a pasta atual é a única pasta na qual o ativo reside. Excluí-lo aqui remove completamente o ativo do Orchestrator. Você precisa da permissão Ativos — Criar nas pastas em que deseja adicionar o ativo (pastas de destino) e Ativos — Exibir na pasta em que o ativo reside atualmente (pasta original). Se você tiver Ativos - Editar na pasta de destino, você não precisará de Ativos - Editar na pasta original. Depois que um ativo é compartilhado em uma pasta, os usuários com Ativos - Editar na pasta de destino podem editar o ativo, e as alterações serão aplicadas globalmente.

Vinculação de vários ativos à pasta Atual

1. Na pasta à qual você deseja vincular um ativo, na página Ativos , selecione Adicionar. Três botões são exibidos, permitindo que você adicione um ativo, vincule ativos de outras pastas ou oculte as opções.
2. Selecione Vincular de outras pastas. A janela Vincular ativos é exibida, mostrando uma lista de todos os ativos nas pastas nas quais você tem permissões de Visualizar os ativos.

Figura 1. Vinculação de ativos de outras pastas

3. Na seção Selecionar ativos, selecione um ou vários ativos da lista.
4. Selecione Continuar. Você será direcionado à seção Validação da pasta. Aqui você pode ver as pastas às quais os ativos já estão vinculados. Se houver várias pastas, seus nomes serão exibidos.

Figura 2. Validando pasta

5. Selecione Remover para o ativo correspondente reverter a alteração ou Selecione Sair para cancelar a operação.
6. Selecione Vincular se você quiser fazer o link entre os ativos que você selecionou e a pasta atual. Os ativos são exibidos na página Ativos.

Vinculação de um ativo a várias pastas

1. Navegue até uma pasta na qual o ativo a ser vinculado reside.

Selecione Mais ações > Gerenciar vínculos para o ativo desejado abrir a janela Gerenciar vínculos. A janela Gerenciar links do ativo é exibida.

Figura 3. Gerenciamento de links de ativos

1 — painel à esquerda exibindo todas as pastas em que você recebeu permissões de Exibir em Ativos.

2 — o estado atual do ativo exibindo o número de pastas em que ele reside atualmente, assim como seus nomes.

3 - As pastas às quais o ativo deve ser adicionado, de acordo com sua seleção no painel à esquerda.

4 - As pastas das quais o ativo será removido.

1. Selecione Atualizar. Uma janela de confirmação será exibida.
2. Selecione Cancelar se quiser abortar as alterações ou Continuar para que as alterações entrem em vigor. As operações estão agora refletidas no Orchestrator de acordo com suas alterações.

Desvinculação de ativos das pastas

A desvinculação de ativos das pastas pode ser executada de uma maneira semelhante à operação de vinculação. Navegue até as áreas de gerenciamento de vínculos apresentadas nos procedimentos acima e remova as conexões entre um determinado ativo e uma determinada pasta.

Ou então, você pode remover um ativo usando a funcionalidade Remover. Consulte Removção de um ativo.

Importante:

A remoção de um ativo que existe em várias pastas apenas o remove da pasta na qual a operação de remoção ocorrer; ela não o removerá das outras pastas. Para excluir completamente um ativo, você deve remover todos os seus links existentes.

Edição de ativos

Para editar um ativo, clique em Mais Ações > botão Editar , faça as alterações necessárias e clique em Atualizar na janela Atualizar ativo . Apenas o valor e o nome do ativo podem ser editados. Todas as alterações são auditadas e podem ser visualizadas na página Auditar . Se você alterar o nome de usuário de um ativo de credencial, também precisará alterar a senha.

Remoção de valores de ativo por usuário e por robô

Você pode remover valores de ativos definidos para usuários ou robôs específicos diretamente do editor de ativos.

1. Abra Ativos.
2. Crie um novo ativo ou edite um ativo existente.
3. Na seção Valor do ativo, escolha o valor que você deseja remover.
4. Selecionar Remover.
5. Selecione Excluir na caixa de diálogo de confirmação.

Você também pode selecionar várias entradas e removê-las simultaneamente usando a opção Remover no cabeçalho da grade.

Como adicionar tags a ativos

Observação:

Você precisa ter as permissões de Editar em Ativos e Exibir em Tags para adicionar tags existentes aos ativos. Você precisa ter as permissões de Editar em Ativos e Criar em Tags para adicionar novas tags aos ativos.

Observação:

• Cada ativo pode ter no máximo um milhão de pares de chave/valor.
• Rótulos e propriedades de chave/valor tem um limite de 256 caracteres.
• Nomes de tag não podem conter estes caracteres: <, >, %, &, , ?, /, :.

É possível aplicar tags em um ativo no momento de sua criação ou ao editar um já existente. Para adicionar tags a um ativo ao editá-lo, siga estas etapas:

1. Na página Ativos , selecione Mais ações > Editar ao lado do ativo desejado. O ativo é aberto para edição.
2. No campo Rótulos, comece a digitar o nome do rótulo. Você pode escolher um rótulo existente ou criar um novo.
3. No campo Propriedades (pares de chave-valor) , selecione Adicionar novo.
4. Adicione novas chaves e valores. Você pode escolher chaves e/ou valores existentes, ou pode criar novos.
5. Quando finalizar, selecione Atualizar. Seu ativo será atualizado e as tags recém-criadas, se houver, ficarão disponíveis para outros objetos.

Como remover tags de ativos

Para remover tags de um ativo, siga estas etapas:

1. Na página Ativos , selecione Mais ações > Editar ao lado do ativo desejado. O ativo é aberto para edição.
2. No campo Rótulos , selecione o X ao lado do nome do rótulo para removê-lo. O rótulo será removido.
3. No campo Propriedades (pares de chave-valor), selecione o X adjacente às chaves e/ou valores para removê-las. As chaves e/ou valores serão removidos.
4. Para excluir um par de chave/valor, selecione o ícone Remover correspondente a essa entrada. O par chave/valor será removido.
5. Quando finalizar, selecione Atualizar. Seu ativo é atualizado e as tags são removidas.

Remoção de ativos

To remove an asset, click More Actions > Remove.

Alternativamente, selecione um ou vários ativos e clique no botão Remover.