Nesse conteúdo vamos aprender um pouco de como funciona a estrutura de receitas do RPilot e como trabalhar com as variáveis de instalação de uma receita.
Para que a receita possa funcionar de acordo com as informações da sua instituição, por exemplo, dados e valores necessárias e exclusivas da usa infraestrutura, o RPilot fornece uma opção de inserção de variáveis específicas que a receita entende como sendo os parâmetros da instalação.
No caso do IDP da CAFe existem 36 variáveis necessárias para a instalação correta do IDP. Que podemos dividir em 4 subclasses:
Informações para certificado Shibboleth e metadado
Informação para conexão e configuração com base de diretório LDAP/AD
Informações para configuração de um webserver Apache
Informações para configuração do recurso do Dashboard MFA integrado ao IDP CAFe
ORGANIZATION -> Nome da Instituição por extenso. Exemplo: Rede Nacional de Ensino e Pesquisa
INITIALS -> A sigla da instituição. Exemplo: RNP
CITY -> Cidade da instituição. Exemplo: Brasília
STATE -> Unidade Federativa da instituição. Exemplo: DF
URL -> Endereço da página institucional. Exemplo: https://www.rnp.com
OU -> Sigla do setor técnico. Exemplo: DTI
CONTACTGIVEN -> Nome do responsável técnico. Exemplo: João Silva
CONTACTMAIL -> Endereço de email do contato. Exemplo: joao.silva@rnp.br
CONTACTSUR -> Sobrenome do contato apenas. Exemplo: Silva
LDAPATTR -> Atributo para autenticação na CAFe. Exemplo: uid, mail ou sAMAccountName
LDAPDN -> DN onde consulta os usuários na base LDAP. Exemplo: ou=pessoas,dc=rnp,dc=local
LDAPFORM -> Formato para construção das consultas na base LDAP. Exemplo: uid=%s,dc=rnp,dc=local
LDAPPWD -> Senha do usuário de BIND da base LDAP.
LDAPSERVER -> Endereço do servidor LDAP. Exemplo: 192.168.1.20
LDAPSERVERPORT -> Porta usada para conexão LDAP. Exemplo: 389 ou 636
LDAPSERVERPROTO -> Protocolo de comunicação LDAP. Exemplo: ldap:// ou ldaps://
LDAPSERVERSSL -> Valor 0 para SEM SSL e valor 1 para COM SSL.
LDAPSUBTREESEARCH -> Permitir consulta vertical abaixo do DN LDAP informado, por padrão essa opção deve estar 'true'. Exemplo: true
LDAPUSER -> Usuário de BIND para consulta no LDAP. Exemplo: uid=leitor-shib,ou=pessoas,dc=rnp,dc=local
DIRECTORY -> Essa variável vai tratar sobre qual o tipo de diretório você está conectando ao IDP. Essa informação e crucial que esteja certa para o correto funcionamento do IDP. Você só pode usar dois valores:
OPENLDAP
ou
AD
Passar esse valores em MAIUSCULO
DOMAIN -> Apenas o domínio da instituição. Exemplo: rnp.br
HN -> Apenas o nome do servidor, sem domínio. Exemplo: idp
HN_DOMAIN -> Apenas o domínio. Exemplo: cafe.rnp.br
IP -> Digitar o IP do servidor IDP. Se estiver usando NAT digitar o IP NAT.
PAINEL_ADMIN_EPPN -> Exemplo, se valor de eppn for abc@instituicao.br, deve ser cadastrado somente abc: associado também ao cadastro do administrador. O EPPN na maior parte das instituições é o MD5 do username. Em caso de dúvidas do valor, peça para o usuário administrador acessar a url https://sp.rnp.br/ e se autenticar. Após a autenticação, será exibida a informação eduPerson-eduPersonPrincipalName. Pegue a informação que vem antes do @. A figura a seguir mostra um exemplo onde é retornado “73637a38dea854e281cda9f6f00af507@instituicao.br”.
PAINEL_ADMIN_NAME -> Será criada uma conta inicial de administrador para o usuário em questão: quando o painel de segurança é instalado, é cadastrado automaticamente um usuário inicial que receberá permissão de administrador. Será este usuário que irá atribuir permissões de administrador e operador a outros usuários. Certifique que todos os dados do usuário administrador inicial foi cadastrado corretamente
FQDN -> se trata do FQDN do seu servidor IDP. Exemplo: “idp.instituicao.br”
SMTP_ASSINATURA -> Nome que irá aparecer no email enviado como remetente. Exemplo: Instituição de Pesquisa e Educação.
SMTP_EMAIL_ORIGINADOR -> E-mail do originador. Se trata do e-mail que será exibido para o usuário como originador do e-mail. Exemplo: no-reply@instituticao.br
SMTP_HOST -> se trata dos dados de acesso necessários para que o painel de segurança possa enviar e-mails. Preencha aqui o endereço do servidor SMTP. Exemplo: smtp.instituicao.br
SMTP_NOME_AMIGAVEL -> Digite o Nome amigavel a ser exibido para identificar quem envia os e-mails: na ser exibido para identificar quem envia os e-mails. Exemplo: Nome da Instituição
SMTP_PASSWORD -> senha para autenticação na conta SMTP.
SMTP_PORT -> porta do servidor SMTP. Exemplo: 587
SMTP_USERNAME -> conta a ser utilizada para se autenticar no servidor SMTP
MSG_AUTENTICACAO -> Mensagem que irá aparecer na tela de login para os usuários. Exemplo: Digite aqui sua matrícula:
URL_RECUPERACAO_SENHA -> Caso possua uma URL para direcionar seus usuários para um sistema de recuperação de senha digite aqui esse endereço. Exemplo: https://endereco_recuperacao.com.br/
Ao terminar de preencher todos os campos clicar no botão "Próximo" ao final do rodapé.
