Conexões internas entre aplicações

Uma conexão interna cria um caminho privado e direcional entre duas aplicações HTTP da mesma organização. A aplicação de origem passa a chamar a aplicação de destino por um endereço interno, sem passar pela internet. Isso funciona inclusive quando o destino é privado e não tem URL pública.

Como funciona

Cada conexão tem uma origem (quem chama) e um destino (quem recebe). A origem chama o destino em:

http://<projeto>.<id-da-organização>.zenifra.local

• <projeto> é um identificador curto, em letras minúsculas, números e hífens, definido na primeira vez que o projeto participa de uma conexão. <id-da-organização> é o identificador de 24 caracteres hexadecimais da organização, exibido no Console e na API. Por exemplo: http://checkout-api.6a11bedda78ad3108eb20e2c.zenifra.local.
• O endereço usa o identificador da organização para ser único e não muda se o projeto ou a organização forem renomeados.
• O tráfego público da aplicação continua protegido por HTTPS. Apenas a chamada pelo endereço interno usa HTTP na porta padrão, porque ela trafega só dentro da rede privada da sua organização; não é preciso configurar certificado para ela.
• O endereço interno do destino aparece no mapa depois que o projeto é destino de uma conexão pela primeira vez, e permanece o mesmo depois.

Regras

• A conexão vale somente na direção criada. Conectar A a B não permite que B chame A.
• Não há caminho transitivo. Se A chama B e B chama C, A não alcança C.
• Sem conexão, nada muda: não existe caminho privado entre as aplicações. Aplicações públicas continuam se falando pela URL pública.
• Renomear o projeto ou a organização não altera o endereço interno. Chamadas existentes continuam funcionando.
• Origem e destino precisam ser aplicações HTTP da mesma organização (não previews). O destino precisa estar pronto para receber a conexão; caso contrário, a criação é recusada até que ele esteja.
• Ambientes de preview não participam de conexões.

Criar uma conexão

1. Abra o mapa de aplicações da organização no Console.
2. Arraste do conector da aplicação de origem até a aplicação de destino.
3. Confirme a criação.
4. Aguarde o status da conexão mudar de Preparando para Ativa. Depois que o reinício da origem terminar, o endereço fica disponível em todas as instâncias dela.
5. Na aplicação de origem, chame http://<projeto>.<id-da-organização>.zenifra.local com o endereço exibido no mapa.

Em vez de arrastar, clique em Conectar recursos, escolha a origem e o destino, clique em Revisar conexão e confirme.

A aplicação de origem pode ser reiniciada para aplicar a mudança.

Você precisa de permissão para alterar conexões de saída na origem e conexões de entrada no destino. O proprietário da organização tem as duas.

Remover uma conexão

Ao desligar, novas conexões do par são bloqueadas imediatamente. Conexões já abertas não são interrompidas pelo desligamento em si, mas podem ser encerradas se a aplicação de origem for reiniciada para aplicar a mudança.

Se uma operação falhar, a conexão fica com o status Falhou e você pode tentar a mesma ação novamente.

Organizar o mapa

Arraste o corpo de um cartão para mudar somente sua posição. Mover, aproximar ou sobrepor cartões não cria nem remove conexões. A posição é salva separadamente por usuário e organização.

Próximos passos

• Consulte a referência da API de conexões entre aplicações.
• Revise as opções de configuração do projeto.
• Veja como configurar domínios personalizados.