Ir para o conteúdo

Ambientes

Introdução

A página Ambientes do Management Console permite que os administradores da organização Harmony configurem ambientes dentro de uma organização para definir e gerenciar o ciclo de vida de um projeto de integração. Você deve configurar pelo menos um ambiente para criar projetos dentro do Harmony.

Membros de uma papel que recebeu Read acesso ao ambiente também pode acessar a página Ambientes. Membros de uma papel que recebeu Write acesso ao ambiente tem acesso de gravação nesse ambiente.

Cada projeto de integração é implantado em um ambiente Harmony específico. Os ambientes podem ser usados para segregar diferentes estados de um projeto de integração. Por exemplo, uma configuração comum de ciclo de vida de projeto pode ter três ambientes: Development, Test e Production.

O acesso que os usuários têm em um ambiente específico depende da combinação das permissões de sua função e seu acesso ao ambiente:

Para acessar um ambiente, todas as funções (mesmo funções com permissão Admin) devem ter acesso concedido a um ambiente para a maioria dos aplicativos. Isso inclui poder acessar áreas de aplicativos Harmony que exigem que um ambiente seja selecionado e a capacidade de instalar agentes em um ambiente. As exceções são o EDI e App Builder aplicativos que não exigem que nenhum nível de acesso ao ambiente seja concedido às funções; o acesso a esses aplicativos é regido por permissões de papel sozinho.

Quando estiver pronto para mover um projeto entre ambientes, como de Desenvolvimento para Teste, você migra o projeto. Isso pode ser feito de dentro do Cloud Studio (consulte Migração de projeto) ou Design Studio (em Arquivo > Migrar Projeto).

Nota

Depois de fazer alterações em um ambiente, talvez seja necessário sair e entrar novamente no portal Harmony para que essas alterações tenham efeito em outros aplicativos Harmony.

Acesse a Página de Ambientes

Os usuários podem ver ou editar a página Ambientes dependendo da combinação das permissões da função da organização e seu acesso ao ambiente:

  • Membros de uma papel com permissão somente Leitura, cuja papel recebeu acesso a um ambiente, podem ver informações sobre o ambiente na página Ambientes, mas não podem editá-lo.
  • Membros de uma papel com permissão Admin podem ver e usar todas as ações para todos os ambientes na página Ambientes (mesmo que não tenham recebido acesso de papel ao ambiente).

Para acessar a página Ambientes, faça login no portal Harmony, então use o menu do portal Harmony no canto superior esquerdo para ir para Management Console > Ambientes:

Ambientes do Management Console

Nota

Certifique-se de que está acessando a organização desejada, que pode ser alterada na barra de navegação superior (consulte Alterando a organização selecionada no portal Harmony).

Gerenciar Ambientes

Os administradores da organização Harmony (membros de uma papel com permissão Admin) gerenciam cada ambiente e os grupos de agentes associados a ele. Membros de uma papel com permissão somente Read cuja papel recebeu acesso a um ambiente podem ver informações sobre o ambiente, mas não podem adicionar, editar ou remover ambientes.

Visualizar Ambientes

A seção superior da página Ambientes contém uma tabela que mostra todos os ambientes aos quais você tem acesso dentro da organização selecionada:

Tabela de ambientes

A tabela exibe informações para cada ambiente. Esses campos são configuráveis conforme explicado nas próximas seções:

  • Nome: O nome do ambiente.

  • ID: O ID do ambiente.

  • Classe: A classe do ambiente somente para fins de relatório.

  • Grupo de Agente: O grupo de agentes associado ao ambiente. Para obter mais informações, consulte Agentes.

  • Prefixo de URL: O prefixo de URL do ambiente, a ser usado com APIs personalizadas, OData e proxy criadas com API Manager.

  • Limite de acessos: O número máximo de acessos de API por minuto no ambiente, para uso com API Manager.

Outros campos na tabela contêm estatísticas preenchidas automaticamente sobre seu ambiente, incluindo contagens destes itens:

Para classificar a tabela, clique em qualquer um dos cabeçalhos de coluna.

Para filtrar a tabela, use a caixa de pesquisa para inserir os critérios de filtro. Passe o mouse sobre o ícone para revelar um exemplo da sintaxe de pesquisa.

Muitas colunas ficam ocultas quando você abre a página pela primeira vez. Para alterar a visibilidade e a ordem das colunas, clique em Configurações de coluna. A gaveta lateral Colunas abre:

Editor de colunas

  • Filtrar colunas: Insira parte ou todo o nome de uma coluna para reduzir a lista para aqueles que correspondem ao texto.

  • Mostrar tudo: Torna todas as colunas visíveis.

  • Mover: Arraste e solte para alterar a posição da coluna em relação às outras.

  • Ocultar: A coluna está visível. Clique para ocultá-la.

  • Mostrar: A coluna está oculta. Clique para mostrá-la.

  • Salvar: Salve quaisquer alterações nas colunas.

  • Cancelar e Fechar: Fecha o editor de colunas sem salvar as alterações.

Adicionar Ambientes

Pelo menos um ambiente deve ser definido para cada organização. Você pode estar limitado ao número de ambientes que pode criar com base no seu plano de assinatura Harmony. Se precisar de ambientes adicionais, entre em contato com seu Gerente de Sucesso do Cliente.

Para adicionar um ambiente, clique em Adicionar ambiente. Uma nova linha aparece na tabela:

Adicionar ambiente

  • Nome: O nome do novo ambiente (por exemplo, Desenvolvimento, Teste ou Produção).

    Nota

    Esses caracteres especiais não são permitidos:

    < > # % { } | \ / ^ ~ [ ] ` ; , : ? @ = &

  • Classe: A classe do novo ambiente. Use o menu suspenso para selecionar uma classe que melhor descreva o ambiente. Este campo é apenas para fins de relatório e não afeta o funcionamento de um ambiente.

  • Grupo de Agente associado: O grupo de agentes que você deseja usar para atender ao novo ambiente. Use o menu suspenso para selecionar um grupo de agentes para o ambiente, escolhendo entre um grupo de agentes privado configurado por meio da página Grupos de agentes (consulte Agentes) ou um dos grupos de agentes de nuvem do Jitterbit (disponível por padrão).

  • ** Prefixo de URL:** O prefixo de URL do ambiente, a ser usado com APIs personalizadas, OData e proxy criadas com API Manager. Por padrão, o nome do ambiente é usado. Para obter mais informações, consulte URL do serviço de API.

    Quer você use o ambiente padrão ou insira um nome personalizado, o prefixo de URL se torna parte integrante de um API Manager URL do serviço de API. O prefixo de URL é limitado a um máximo de 48 caracteres.

    Nota

    Esses caracteres especiais não são permitidos:

    < > # % { } | \ / ^ ~ [ ] ` ; , : ? @ = &

    Além disso, espaços não são permitidos.

  • Limite de acessos: O número máximo de acessos de API personalizados por minuto no novo ambiente, para uso com API Manager. Se deixado em branco, não há limite para o número de acessos de API no nível do ambiente e o limite de acessos por minuto assume como padrão o limite da organização em todas as APIs em todos os ambientes (conforme declarado no seu contrato de licença do Jitterbit). Para obter informações adicionais, consulte Limitação de taxa no nível do perfil em Segurança do API Manager.

  • Descrição: Uma descrição do novo ambiente.

Clique Salvar para salvar as configurações ou Cancelar para cancelar.

Editar Ambientes

Para editar um ambiente após sua criação, passe o mouse sobre uma linha e clique no botão Editar na coluna Ação:

Editar ambiente

Os campos editáveis são os mesmos de adicionar um ambiente.

Excluir Ambientes

Para remover um ambiente, passe o mouse sobre uma linha e clique em botão Excluir na coluna Ação. A caixa de diálogo Excluir ambiente abre:

Caixa de diálogo Excluir

Para continuar a ação, insira a palavra DELETE no campo de texto e clique no botão Delete.

Para abandonar a ação, clique no botão Cancel.

Gerenciar Acesso de Papel a Ambientes

Antes de conceder acesso de papel a um ambiente, você deve definir as funções que podem ter acesso. A associação individual para essas funções é definida no nível do usuário. Depois que as funções forem definidas, você pode conceder às funções diferentes níveis de acesso a um ambiente.

Os níveis de acesso em nível de ambiente são usados em combinação com permissões de papel para aumentar a capacidade dos administradores de controlar o que os membros de uma papel específica podem fazer em um ambiente específico. Por exemplo, usuários em uma papel de desenvolvedor de nível de entrada podem ter acesso de Leitura, Execução e Gravação em um ambiente de desenvolvimento, mas somente acesso de Leitura em um ambiente de teste e nenhum acesso em um ambiente de produção.

Níveis de Acesso

Ao conceder acesso de papel a um ambiente, você pode selecionar um dos quatro níveis de acesso de ambiente em cascata. View Logs é o nível mais baixo de acesso, seguido por Read, Execute e então Write como o nível mais alto de acesso. Conforme você seleciona um nível mais alto de acesso, todos os níveis de acesso mais baixos são selecionados automaticamente e não podem ser limpos.

Os níveis de acesso são independentes e diferentes das permissões atribuídas a uma papel. Por exemplo:

  • Um membro de uma papel com permissão de Leitura ainda poderá fazer edições em um ambiente se o acesso de Gravação for concedido à papel no nível do ambiente.
  • Um membro de uma papel com permissão Admin, mas que tem apenas acesso Leitura no nível do ambiente, não consegue implantar, executar ou editar projetos nesse ambiente.
  • Um membro de uma papel com permissão Admin, mas que não recebeu acesso ao ambiente, não consegue acessar o ambiente.

Os quatro níveis de acesso ao ambiente são descritos na tabela abaixo.

Nota

O acesso conforme descrito abaixo é fornecido somente se a papel atribuída tiver permissão Read ou Admin. Se a papel tiver apenas permissão Agent-Install, ApiConsumer ou App Developer, os membros dessas funções não terão acesso às páginas ou ações descritas aqui, apesar dos níveis de acesso do ambiente serem selecionados.

Dica

Os níveis de acesso ao ambiente não concedem acesso adicional ao EDI e App Builder aplicativos; o acesso a esses aplicativos é regido por permissões de papel.

Nível de acesso ao ambiente Nível de acesso Acesso ao ambiente quando concedido a uma função
com permissão Read ou Admin
Notas
Exibir Logs Mais baixo Acesso a: O acesso à página Operações de tempo de execução é limitado à visualização da tabela de operações e não inclui a capacidade de acessar mensagens de log (consulte Mensagens de log em Operações de tempo de execução). Para visualizar mensagens de log, é necessário acesso Execute ou superior. View Logs é selecionado automaticamente se qualquer outro nível de acesso (Read, Execute ou Write) for selecionado.
Ler Baixo Acesso a: O acesso às páginas e aplicativos listados acima é limitado à visualização de páginas ou à abertura de configurações de componentes. O acesso de leitura não inclui a implantação de projetos.

Read é selecionado automaticamente se o acesso Execute ou Write for selecionado.

Quando esse nível de acesso é selecionado, o nível de acesso View Logs é selecionado automaticamente e não pode ser limpo.

Esse nível de acesso é comumente usado para limitar o acesso a projetos implantados em ambientes críticos, como um ambiente de produção.

Quando concedido a uma papel com permissão ApiConsumer, o acesso Read fornece acesso ao API Manager Portal página através de um link direto.

Executar Alto Acesso para executar estas ações:

Executar é selecionado automaticamente se o acesso Gravar for selecionado.

Quando esse nível de acesso é selecionado, os níveis de acesso Exibir logs e Leitura são selecionados automaticamente e não podem ser limpos.

Esse nível de acesso é comumente usado para limitar o acesso em ambientes de teste e geralmente é concedido a usuários que precisam dar suporte a uma integração, pois podem precisar executar operações e visualizar logs de operação.

Em organizações cuja assinatura do Harmony expirou, esse nível de acesso é efetivamente o mesmo que o nível de acesso Leitura.

Escrever Mais alto Acesso e capacidade de fazer edições e executar ações como implantação (quando aplicável) em: Acesso somente leitura para:

Quando esse nível de acesso é selecionado, os níveis de acesso Exibir logs, Ler e Executar são selecionados automaticamente e não podem ser limpos.

Quando concedido a uma papel com permissão Instalar agente, o acesso Gravar fornece a capacidade de instalar agentes.

Em organizações cuja assinatura do Harmony expirou, esse nível de acesso é efetivamente o mesmo que o nível de acesso Leitura.

Portal do API Manager

Esses critérios adicionais devem ser atendidos antes que a página do Portal do API Manager fique acessível:

Além do acesso pelo aplicativo API Manager, a página Portal pode ser acessada por:

  • Um link direto para consumidores de API que têm permissão ApiConsumer em uma organização e um mínimo de acesso Read em um ambiente. Para obter o link direto, copie a URL da página do API Manager Portal ou o link para View API Documentation na página do Portal Manager.

  • Um convite de um administrador da organização Harmony através do Management Console Gerenciamento de Usuários página.

Visualizar e Editar o Acesso de Papel a um Ambiente

Para visualizar ou editar o acesso de papel de um ambiente, selecione uma linha na tabela. Na seção inferior da página Ambientes, o painel Acesso de Função exibe todas as funções que podem receber acesso ao ambiente selecionado:

Acesso de função

Nota

Se uma papel que anteriormente tinha acesso concedido a um ambiente for desativada ou tiver sido excluída (do Gerenciamento de usuários página), a papel não será exibida.

Para selecionar ou limpar um nível de acesso, habilite ou desabilite a alternância de nível de acesso. Uma caixa de diálogo de confirmação é exibida.

Para limpar todos os níveis de acesso de uma papel, clique no nível de acesso Exibir logs de uma função para desativar a seleção.

Os níveis de acesso disponíveis em um ambiente são descritos em detalhes acima em Níveis de acesso.

Conceder Acesso de Papel a um Ambiente

Selecione um ambiente para revelar o painel Acesso à função na parte inferior da tela:

Acesso de função

  • Pesquisar: Pesquise funções que correspondam ao texto. As pesquisas não diferenciam maiúsculas de minúsculas. Para mostrar todas as funções, exclua o texto.

  • Atualizar: Atualizar as funções.

  • Anterior: Selecione o ambiente anterior na tabela.

  • Próximo: Selecione o próximo ambiente na tabela.

  • Tela cheia: Aumente o tamanho do painel Role Access para preencher a janela do navegador.

  • Sair da tela cheia: Retorna o tamanho do painel Role Access ao normal.

  • Fechar: Feche o painel Acesso à função.