# Customização da mensagens de login no IDP

* Ajustar as mensagens na tela de login

### Ajustar as mensagens na tela de login

{% hint style="danger" %}
Antes de começar !

Recomendado que seja criado um backup do arquivo "**messages\_pt\_BR.properties**" antes de começar as alterações abaixo.

Caminho para o arquivo: **/opt/shibboleth-idp/messages**

Qualquer problema após as modificações, basta retornar com o arquivo original.
{% endhint %}

{% hint style="info" %}
Aviso

As mudanças realizadas abaixo foram homologadas em um ambiente com a VM template construída com o Sistema Operacional (Ubuntu 24.04 + Shibboleth 5.1.X). Os locais dos arquivos podem variar em outras versões do Template, ou se a instalação do seu IdP foi construído manualmente.
{% endhint %}

### Guia Passo a Passo:

Esse roteiro ira ajudar na customização das mensagens da tela do login do seu IdP:

Todas as alterações serão feitas no arquivo **messages\_pt\_BR.properties**, para isso abra o arquivo com um editor de sua preferência, o caminho é **/opt/shibboleth-idp/messages**

1. Campo **Username**, alterando a mensagem:

![](https://3706451151-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M94Z581aPIo4Bzo9ImS%2Fuploads%2F6PHgPlFNAswIsEi8t0MK%2Flogin-1.png?alt=media\&token=4563acd7-389a-4b5d-829c-28dd5fcd262c)

Altere as entradas **idp.login.username.label** para alterar a mensagem do campos **Username** respectivamente, pode ser usado para informar aos clinetes que irão usar o seu IdP como devem proceder com o acesso a CAFe.

Para inserir uma nova mensagem basta apagar a mensagem atual em vermelho e escrever sua nova mensagem ao usuário, lembrando que a formatação deve ser respeitada, mantenha um **espaço** entre o valor **=** e o inicio da sua nova mensagem.

![](https://3706451151-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M94Z581aPIo4Bzo9ImS%2Fuploads%2FLLfQZJZBZT1Y19vQhyH1%2Flogin-2.png?alt=media\&token=e7321ca0-9c14-4c2c-9da8-7c7790f1f662)

Feita a alteração basta salvar o arquivo com seu editor e executar o comando build.sh do shibboleth para que ele possa carregar as novas alterações. Para isso faça:

```
sudo cd /opt/shibboleth-idp/bin
sudo ./build.sh
...
Buildfile: /opt/shibboleth-idp/bin/build.xml

build-war:
Installation Directory: [/opt/shibboleth-idp] ?
```

Nesse momento o script estará te perguntando em qual diretório padrão está a instalação do Shibboleth, por padrão é esse mesmo **/opt/shibboleth-idp** então basta apertar a **tecla \[Enter]**

**Aguarde a seguinte mensagem:**

```
INFO [net.shibboleth.idp.installer.BuildWar:103] - Rebuilding /opt/shibboleth-idp/war/idp.war, Version 4.1.5
INFO [net.shibboleth.idp.installer.BuildWar:113] - Initial populate from /opt/shibboleth-idp/dist/webapp to /opt/shibboleth-idp/webpapp.tmp
INFO [net.shibboleth.idp.installer.BuildWar:92] - Overlay from /opt/shibboleth-idp/edit-webapp to /opt/shibboleth-idp/webpapp.tmp
INFO [net.shibboleth.idp.installer.BuildWar:125] - Creating war file /opt/shibboleth-idp/war/idp.war

BUILD SUCCESSFUL
Total time: 2 minutes 45 seconds
```

**Essa mensagem indica que o rebuild ocorreu como esperado !**

**Agora vamos reinicar o shibboleth, faça:**

<pre><code><strong>sudo systemctl restart jetty.service
</strong></code></pre>

**Pronto !** Agora você pode verificar como ficou sua modificação, acesse o portal **<https://sp.rnp.br/chimarrao>** escolha sua instituição e clique em "**Prosseguir**" na próxima tela será apresentado a caixa de login e senha da sua instituição e se tudo deu certo a sua nova mesnagem estará aparecendo.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://ajuda.rnp.br/cafe/idp-cafe/faq/customizacao-da-mensagens-de-login-no-idp.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
