Section Access

O Section Access é a segurança por linha do Qlik: ele decide quais dados cada pessoa vê dentro de um app. No Qovern, as regras ficam numa tela própria, fora do script de carga, e cada alteração é validada, publicada no Qlik e registrada na auditoria.

Como funciona

1. Você edita as regras do app na tela Section Access.
2. Ao clicar em Salvar e Aplicar Regras, o Qovern valida tudo, grava uma nova versão e gera um arquivo CSV.
3. O CSV é enviado para a conexão DataFiles do espaço do app no Qlik.
4. No mesmo clique, o Qovern insere ou atualiza o script no app e pede ao Qlik para recarregar o app, e as regras novas passam a valer.

O script do app ganha uma aba Section Access que lê esse arquivo. Você não precisa mais editar o script para mudar quem vê o quê.

Colocar um app sob gestão

1. Em Aplicativos, encontre o app e clique em Provisionar o Section Access.
2. O Qovern cria a primeira regra, uma linha ADMIN protegida para o dono do app, e insere a aba de Section Access no script.
3. O app passa a aparecer em Section Access, pronto para receber as regras.

O plano Standard governa até 10 apps. Só apps analíticos podem ser provisionados: scripts de dados e fluxos de dados não têm Section Access.

Atenção: se o app já tem um Section Access aplicado de um script anterior, o Qlik pode negar a edição do script. Recarregue o app uma vez sem o bloco antigo e tente de novo.

Escrever as regras

Cada linha da tabela é uma regra com estas colunas:

Coluna	O que significa
ACCESS	ADMIN (vê tudo) ou USER (vê só o que a linha libera).
E-mail (USER.EMAIL) ou Grupo do IdP (GROUP)	Quem a regra afeta. Cada linha usa uma das duas formas, nunca as duas.
Campos de redução (uma coluna por campo)	O valor que essa pessoa ou grupo pode ver em cada campo (por exemplo, o código da filial). * libera todos os valores listados na tabela.
OMIT (campos ocultos)	Campos que a pessoa não vê no app, separados por vírgula.

Regras importantes:

• valores de ACCESS e dos campos de redução ficam em maiúsculas;
• o grupo precisa estar escrito exatamente como no seu provedor de identidade (IdP), respeitando maiúsculas e minúsculas;
• regras repetidas são recusadas;
• a linha ADMIN protegida não pode ser removida: ela garante que alguém sempre consiga abrir e configurar o app.

Campo de redução

O Section Access do Qlik reduz os dados pelo nome do campo: cada coluna de redução só funciona se tiver exatamente o mesmo nome de um campo do modelo do app. O padrão é um campo só, CHAVE. Os campos ficam em Campos de redução, logo acima das regras. O Qovern sugere os nomes dos campos que já conhece do app (a partir da documentação gerada).

Quando um campo só não basta, use Adicionar campo (até 10). Cada campo vira uma coluna na tabela, no arquivo e no script. Numa mesma regra, os campos valem juntos: com FILIAL = 10 e REGIAO = SUL, a pessoa vê só o que é da filial 10 e da região Sul. Para liberar todos os valores de um campo, use *. Para dar acesso a mais de uma combinação, crie uma regra para cada uma.

Os campos são gravados quando você clica em Salvar e Aplicar Regras, junto com as regras, e o Qovern atualiza a aba de Section Access no script do app. Se não conseguir, ele avisa e não recarrega: corrija o que a mensagem indicar e clique de novo em Salvar e Aplicar Regras.

Importar de uma planilha

Para muitas regras de uma vez, use Importar planilha no editor de regras.

1. Baixe o modelo em CSV ou Excel, ou use a sua planilha com as colunas ACCESS, USER.EMAIL ou GROUP, uma coluna para cada campo de redução (com o nome do campo no cabeçalho) e OMIT.
2. Escolha o arquivo (.csv separado por vírgula, ponto e vírgula ou tabulação, ou .xlsx).
3. Confira a prévia: erros aparecem por linha.
4. Escolha Adicionar às regras atuais (regras que já existem são ignoradas) ou Substituir as regras atuais (a linha ADMIN protegida é mantida).

A importação só preenche a tela. Nada vai para o Qlik até você clicar em Salvar e Aplicar Regras. Por segurança, células que parecem fórmula de planilha (começando com =, @, + ou -) são recusadas. O limite é de 5.000 regras por app.

Salvar e recarregar

O botão Salvar e Aplicar Regras, no fim do editor, faz tudo em sequência e para na primeira etapa que falhar:

1. valida, grava uma versão nova e publica o arquivo no Qlik (o resultado aparece em Publicações);
2. insere ou atualiza o script no app;
3. dispara a recarga no Qlik e acompanha o status até o fim. Só uma recarga por app roda de cada vez.

As regras salvas só passam a valer no app depois da recarga.

Espaço do arquivo

Por padrão, o arquivo de regras é gravado no mesmo espaço do app. No seletor Espaço do arquivo de Section Access, no card do app, o administrador pode escolher outro espaço. Ao trocar, o Qovern reescreve o script do app para ler do espaço novo. O arquivo antigo não é apagado do espaço anterior.

O service account do Qovern precisa ser membro do espaço escolhido, com permissão de editar.

Script no aplicativo

O bloco inserido no script lê o arquivo publicado e inclui as linhas de que o Qovern precisa para recarregar o app (o service account também entra como ADMIN, porque é ele quem dispara a recarga). Para ver o bloco e a prévia do arquivo gerado, clique em SCRIPTS, no card do app.

O Qovern reescreve o bloco a cada Salvar e Aplicar Regras, com os campos de redução e o nome do espaço atuais. Se o espaço for renomeado no Qlik, basta salvar de novo. Se o app mudar de espaço, a publicação é recusada com um aviso, e o administrador clica em Usar o espaço atual do Qlik no próprio aviso.

Histórico das regras

O botão LOG, no card do app, abre o histórico do app em três abas, da mais recente para a mais antiga:

• Alterações: quais regras entraram e saíram em cada gravação, e quem fez;
• Publicações: cada versão do arquivo, com status e erro, se houver;
• Cargas: as recargas pedidas pelo Qovern e as que rodaram pelo Qlik.

No plano Standard, o histórico mostra os últimos 30 dias.