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 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. Ao clicar em Recarregar aplicativo, o Qovern 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.
Campo de redução	O valor que essa pessoa ou grupo pode ver (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 do campo 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: a coluna de redução só funciona se tiver exatamente o mesmo nome de um campo do modelo do app. O padrão é CHAVE, mas você pode trocá-lo no card do app, em Campo de redução. O Qovern sugere os nomes dos campos que já conhece do app (a partir da documentação gerada).

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, o campo de redução 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 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

• Salvar regras valida, grava uma versão nova e publica o arquivo no Qlik. O resultado aparece em Publicações.
• Recarregar aplicativo 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. Em Espaço do arquivo, 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). Se o app mudar de espaço no Qlik, ou se o espaço for renomeado, use Usar o espaço atual do Qlik ou Inserir/atualizar script no app no card do app.

Histórico das regras

No card Auditoria recente, Ver histórico completo abre três abas:

• 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.