Barra de navegação do Passaporte Web¶

A barra de navegação do Passaporte Web auxilia na integração da sua aplicação ao restante do ecossistema, além de prover funcionalidades tais como as notificações de forma mais acessível aos usuários. Um exemplo da barra de navegação em uso pode ser visto aqui mesmo, no topo da página. Depois de algum tempo você passará a reconhecer qualquer página que contenha esta barra como parte do ecossistema Passaporte Web, um ambiente confiável e seguro. A lista de aplicações da barra sempre mostrará a aplicação atual como a primeira.

A integração da barra à sua aplicação é requerida para a homologação da mesma.

Integrando a barra do Passaporte Web à sua aplicação¶

Para realizar a integração da barra do Passaporte Web à sua aplicação inclua o javascript da barra em todas as páginas.

<script type="text/javascript"
    src="http://app.passaporteweb.com.br/navbar/:slug.js?login_url=:login_url&logout_url=:logout_url&push_it=:push_it">
</script>

Essa url requer os seguintes parâmetros de GET:

Parâmetro	Descrição	Default	Exemplo
slug	slug da sua aplicação no Passaporte Web		`example`
login_url	url de login da aplicação para o ambiente escolhido		`http://example.com/sso`
logout_url	url de logout da aplicação para o ambiente escolhido		`http://example.com/logout`
push_it	se a barra do passaporte deve “empurrar” a página	`true`	`false`, `0`

Todos os parâmetros devem ser corretamente escapados.
O parâmetro push_it determina como a barra se comporta em relação ao layout da sua aplicação. Se enviado como true a barra irá “empurrar” o layout da sua aplicação para baixo, deixando uma margem onde ficará a barra.
Você deve usar a URL https://sandbox.app.passaporteweb.com.br para o ambiente de teste e https://app.passaporteweb.com.br para o ambiente de produção.
Você deve incluir o javascript preferivelmente ao final da página.