Gerenciar grupos de segurança e atribuições
O gerenciamento de segurança e de acesso do PlaidCloud é simples. Um membro recebe ou tem negado o acesso com base nos grupos aos quais está associado. Adicionar ou alterar a associação de segurança de um membro é fácil de personalizar.
Gerenciar grupos de segurança
Seção intitulada “Gerenciar grupos de segurança”Os grupos de segurança podem ser adicionados, atualizados ou excluídos.
Para gerenciar grupos de segurança:
- Abra o Identity
- Selecione Grupos de segurança na barra lateral (isso exibirá uma lista dos grupos existentes)
- Para adicionar um grupo, clique em Novo grupo
- Para editar as permissões de um grupo, clique no ícone mais à esquerda
Para gerenciar os membros de um grupo:
- Abra o Identity
- Selecione Grupos de segurança na barra lateral
- Clique no ícone Membro
- Marque os membros que devem pertencer ao grupo e desmarque os que não devem. Use a caixa de filtro para encontrar pessoas. Consulte Atribuir com o seletor
- Clique em Atualizar atribuições
Atribuir com o seletor
Seção intitulada “Atribuir com o seletor”Sempre que você dá a pessoas, grupos ou outros itens acesso a algo, uma única lista de verificação substitui o antigo par de listas. Cada linha tem uma caixa de seleção, e uma linha marcada está atribuída. Cada linha mostra o nome e o e-mail em colunas separadas. Você o usa para definir os membros de um grupo, os grupos de segurança de um membro, os membros, grupos, agentes e proprietários de uma conta, o acesso de uma conexão, os membros do espaço de trabalho de uma lista de distribuição e os fluxos de trabalho em um conjunto de prontidão do Weave.
- Filtro. Digite na caixa de filtro para restringir a lista. A correspondência é parcial e ignora maiúsculas e minúsculas; assim,
smithencontra todo nome ou e-mail que o contenha, e@example.comencontra todas as pessoas desse domínio. Ao digitar várias palavras, ficam apenas as linhas que correspondem a todas elas. - Cole uma lista de e-mails. Cole vários endereços de e-mail, separados por espaços, vírgulas, ponto e vírgula ou quebras de linha, e a lista mostra exatamente essas pessoas. Você pode misturar domínios inteiros, como
@example.com. Uma linha abaixo do filtro informa quantas entradas coladas foram encontradas e lista as que não foram. Atribuir seguido do número de correspondências marca com um clique todas as pessoas encontradas. - Todos, Atribuídos e Não atribuídos. Os três botões acima da lista alternam entre tudo, somente o que está atribuído e somente o que não está, cada um com uma contagem. Eles se combinam com o filtro.
- Atribuir todos os exibidos e Remover atribuição de todos os exibidos. Estes marcam ou desmarcam todas as linhas que o filtro e a visão mostram no momento e não mexem nas linhas ocultas. Uma linha acima da lista informa quantas linhas são exibidas do total.
- Será adicionado e Será removido. Nada é salvo até você clicar no botão de salvar. Uma linha que você marcou fica com um tom de destaque e mostra uma etiqueta Será adicionado, e uma linha que você desmarcou mostra Será removido. O resumo acima da lista mostra quantos estão atribuídos e as alterações pendentes. O resumo diz, por exemplo,
12 assigned · +3 to add · −1 to remove. Anular alterações devolve tudo ao estado em que estava quando você abriu a janela. - Salve somente quando algo mudou. O botão de salvar, como Atualizar atribuições, Atualizar membros ou Atualizar grupos, só fica disponível quando você fez uma alteração.
- Teclado. Espaço marca ou desmarca a linha selecionada. Enter na caixa de filtro não salva; portanto, pressioná-lo durante uma pesquisa nunca pode alterar o acesso.
Quando você pode ver quem tem acesso, mas não pode alterá-lo, por exemplo em uma conexão que não é sua, o seletor é somente leitura: uma observação informa isso, e ele lista apenas as pessoas já atribuídas, com as iniciais no lugar das caixas de seleção e sem botões que as alterem.
Gerenciar o acesso a linhas
Seção intitulada “Gerenciar o acesso a linhas”O acesso a linhas restringe quais linhas de uma tabela um grupo de segurança pode ver, com base no valor de uma coluna. Por exemplo, uma coluna region pode restringir o acesso, com um grupo que recebe East e Central limitado às linhas que têm esses valores. Tudo para um projeto e uma coluna — escolher a coluna, escolher de onde vêm os valores e decidir qual grupo vê o quê — acontece em uma única tela, e salvar tem efeito imediato.
Configurar e alterar o acesso a linhas exige um Arquiteto do projeto ou um administrador do tenant. Qualquer outra pessoa que abrir a guia Segurança de um projeto é informada de que o acesso a linhas é exclusivo de Arquitetos, e os pontos de entrada abaixo não aparecem para ela.
Abrir o acesso a linhas
Seção intitulada “Abrir o acesso a linhas”Todos os pontos de entrada abrem a mesma tela de acesso a linhas:
- A barra de ferramentas do Explorador de tabelas tem um botão Acesso a linhas, com um indicador quando a tabela já restringe linhas. Ele abre na primeira coluna restrita da tabela, se houver, e você pode mudar para qualquer outra coluna da tabela.
- O menu de facetas de uma coluna tem Restringir linhas por esta coluna…, que abre o acesso a linhas nessa coluna. Em uma coluna que já restringe linhas, o item diz Linhas restringidas por esta coluna — editar….
- A guia Segurança de um projeto lista todas as colunas restritas do projeto, com as tabelas às quais se aplicam, os grupos que têm concessões e o estado de Sincronizar. Selecione uma coluna para editá-la ou clique em Restringir uma coluna… para iniciar uma nova: escolha uma tabela e depois uma coluna. As colunas que já restringem linhas são marcadas com um cadeado.
- Identity → Member, na guia Acesso a linhas de um membro, e Identity → Security → Grupos de segurança, no resumo de acesso a linhas de um grupo. Abrir acesso por linha (ou Editar) abre a coluna selecionada; Adicionar restringe outra coluna no projeto dessa linha.
Quando aberta em uma coluna, a tela permanece nessa coluna. Quando aberta com Restringir uma coluna… ou Adicionar, ela permite que você escolha uma.
A grade de acesso a linhas
Seção intitulada “A grade de acesso a linhas”Para restringir uma tabela por uma coluna:
- Abra o acesso a linhas por qualquer um dos pontos de entrada acima e escolha a coluna, se você não chegou com uma — o seletor oferece as colunas reais da tabela, não texto livre.
- Escolha uma Origem do valor — Coluna (os valores distintos de uma coluna da tabela), Dimensão (nós de uma dimensão) ou Lista (valores que você digita). O tipo de valor segue o tipo de dados da coluna.
- Para cada grupo de segurança, marque os valores que esse grupo pode ver. A grade lista os grupos com acesso ao projeto, além de qualquer grupo que já tenha uma concessão na coluna.
- Defina Todos os demais como vê todas as linhas ou não vê nenhuma linha — isso abrange qualquer grupo sem marcações na grade.
- Clique em Salvar.
Salvar tem efeito imediato. As próprias consultas do PlaidCloud acompanham a alteração na hora, e seus painéis do Superset em cerca de um minuto — não há uma etapa separada para aplicá-la, e Salvar só para para perguntar quando uma concessão contém um valor que a origem dela não tem mais (veja abaixo). O status de sincronização da tela mostra até onde a alteração chegou; consulte Manter os painéis sincronizados.
A grade também cuida dos detalhes para você:
- Muitos valores. Os valores são ordenados. Quando uma coluna tem mais valores do que cabem, a grade diz “Há mais valores do que cabem aqui — digite para pesquisar.” e a caixa de filtro pesquisa a coluna inteira, mantendo todos os valores que um grupo já possui.
- Valores que a origem não tem mais. Um valor concedido a um grupo permanece na grade quando a origem o perde — nenhuma linha da tabela o tem agora, a dimensão não tem mais o membro ou a lista não o tem mais. O cabeçalho da coluna dele mostra um ícone de aviso, e passar o mouse sobre ele explica o motivo. Selecionar tudo, Inverter e Colar deixam esse valor como cada grupo o possui. Nada é retirado de uma concessão a menos que você o desmarque: quando você clica em Salvar enquanto um grupo ainda possui esse valor, o acesso a linhas nomeia os grupos e os valores em Valores que não estão mais na origem e pergunta. Manter e salvar os salva como estão, Remover e salvar os retira primeiro da concessão de cada grupo, e fechar a pergunta não salva nada. Se removê-los deixasse um grupo sem nada marcado, a pergunta diz se esse grupo passaria a ver todas as linhas ou nenhuma, conforme Todos os demais. Uma marcação que você ainda não salvou vai junto com o valor. Quando uma coluna tem mais valores do que cabem, ou a tabela dela ainda não foi criada, o acesso a linhas não consegue dizer quais valores faltam na tabela e, por isso, mantém todos os valores concedidos sem marcar nenhum.
- Valores em branco. Uma caixa de seleção Valores em branco — visíveis para todos os grupos com concessão decide as linhas sem valor na coluna. Marque-a e todos os grupos com qualquer concessão na coluna veem essas linhas.
- Uma tabela que ainda não foi criada mostra Construa esta tabela primeiro (execute o fluxo de trabalho que a cria) em vez de uma lista vazia.
- Salvar aguarda os valores na tela. Enquanto os valores são carregados — depois de você trocar a origem dos valores, a dimensão ou a tabela, ou aplicar um modelo —, Salvar fica desativado com a dica “Salvar fica disponível quando os valores desta origem forem carregados.” Se um carregamento falhar, a grade informa isso e pede que você escolha a origem novamente; nada é salvo até que um carregamento seja bem-sucedido.
Um nome de coluna, todas as tabelas
Seção intitulada “Um nome de coluna, todas as tabelas”Uma restrição pertence a um nome de coluna do projeto, não a uma única tabela. Depois que region restringe linhas, toda tabela do projeto com uma coluna chamada region é filtrada por ela, tanto nas consultas do próprio PlaidCloud quanto nos painéis. A lista Aplica-se a da grade mostra essas tabelas. Ela é somente leitura, porque o nome da coluna decide isso, e uma tabela que você adicionar depois com a mesma coluna é coberta assim que for publicada.
Quando nenhuma tabela do projeto tem uma coluna com esse nome, a janela avisa que a restrição não filtrará nenhum painel até que uma tabela tenha, além de mostrar Aplica-se a 0 tabelas. Adicione a coluna a uma tabela ou corrija o nome da coluna, e o aviso desaparece.
Parar uma restrição
Seção intitulada “Parar uma restrição”Parar de restringir, na grade, remove a restrição após uma confirmação em linha — “Parar de restringir linhas por ‘region’? A concessão de cada grupo nela é removida e todos passam a ver suas linhas.” O acesso a linhas então confirma “As linhas de ‘region’ não estão mais restritas.” O conjunto de dados do Superset da coluna vai junto, a menos que gráficos ainda o usem; nesse caso, o acesso a linhas informa que o conjunto de dados permanece e quantos gráficos o usam.
Uma coluna não pode ser renomeada nem descartada enquanto restringe linhas. Um Arquiteto é orientado a parar de restringi-la primeiro no acesso a linhas; qualquer outra pessoa é orientada a pedir a um Arquiteto do projeto.
Quem pode alterar um projeto que restringe linhas
Seção intitulada “Quem pode alterar um projeto que restringe linhas”Os fluxos de trabalho, as etapas e as funções definidas pelo usuário de um projeto são executados como a própria identidade de serviço do projeto, que lê todas as linhas. Quem pode alterá-los poderia fazer uma etapa copiar linhas que não lhe foram concedidas para uma tabela que essa pessoa pode ler; por isso, restringir linhas em um projeto também restringe quem pode alterar o que o projeto faz. Depois que um projeto restringe pelo menos uma coluna:
- A automação é exclusiva de Arquitetos. Somente Arquitetos do projeto e administradores do tenant podem alterar fluxos de trabalho, etapas, funções definidas pelo usuário, agendamentos, variáveis de fluxo de trabalho e de projeto e modelos de e-mail de notificação — e, pelo mesmo motivo, importar um pacote de fluxo de trabalho, converter um fluxo de trabalho do Alteryx, importar, copiar ou restaurar no projeto, ou alterar o ambiente de conexão, a conta de documentos padrão ou o modo de lançamento no ERP dele. Todas as outras pessoas ainda podem executar os fluxos de trabalho do projeto: Iniciar, Parar, Retomar e Executar etapa(s) selecionada(s) continuam disponíveis. O editor de etapas, os controles de criação do fluxo de trabalho, o editor de UDF e o formulário de agendamento abrem somente para leitura para elas, com um aviso que nomeia os Arquitetos a quem pedir: “Este projeto restringe linhas; portanto, somente os Arquitetos dele podem alterar fluxos de trabalho, etapas, UDFs, agendamentos, variáveis e modelos de notificação. Você ainda pode executá-los.”
- As dimensões que uma coluna restrita lê são exclusivas de Arquitetos. Uma dimensão que decide quem vê quais linhas — a origem dos valores de uma coluna restrita — só pode ser alterada por um Arquiteto do projeto ou por um administrador do tenant, e pelos próprios fluxos de trabalho do projeto. Isso abrange adicionar, mover, renomear, copiar, limpar, carregar e restaurar seus nós, além da própria dimensão. Qualquer outra pessoa recebe a mensagem “Esta dimensão decide quem vê quais linhas de ‘region’; portanto, somente um Arquiteto do projeto pode alterá-la.” As dimensões que nenhuma restrição lê não são afetadas.
- Uma tabela de origem de concessões é exclusiva de Arquitetos. Uma tabela vinculada como origem de concessões de uma coluna só pode ter as linhas alteradas, ou ser excluída, por um Arquiteto do projeto, por um administrador do tenant ou pelos fluxos de trabalho do projeto — seja pelo Editor de dados, por uma importação, por uma carga de conector ou pela API.
- Copiar o projeto é exclusivo de Arquitetos, e a cópia diz “Esta cópia não tem restrição de linhas.” — o novo projeto não tem restrição até que você configure uma.
- Restaurar uma versão anterior é uma alteração como qualquer outra. Restaurar as configurações do próprio projeto, ou uma dimensão listada acima, exige um Arquiteto do projeto. Uma restauração sempre se aplica ao item ao qual a versão pertence, de modo que não pode ser direcionada a outro projeto para contornar isso — consulte Histórico de versões.
- Editar dados em uma tabela restrita exige um Arquiteto, como descrito em Acesso a linhas e o Editor de dados.
- Gravações de DataFrame, salvamentos de registros e limpezas em uma tabela restrita alteram somente as suas próprias linhas, a menos que você veja todas as linhas, como descrito em Carregar dados em uma tabela restrita.
- Importações, cópias, trocas de branch, restaurações e exclusões de uma tabela restrita são recusadas enquanto ela contiver uma linha que você não consegue ver, como descrito em Carregar dados em uma tabela restrita.
Antes de a primeira coluna de um projeto ser restrita, o acesso a linhas informa quem isso afeta: “Restringir linhas aqui significa que somente Arquitetos podem alterar os fluxos de trabalho, as etapas, as UDFs, os agendamentos e os modelos de notificação deste projeto. N membros podem alterá-los hoje; eles ainda poderão executá-los.”
As execuções continuam funcionando exatamente como antes, inclusive as agendadas, porque são executadas como a identidade de serviço do projeto. O que uma execução produz segue o desenho que os Arquitetos dela definiram: uma tabela de saída sem a coluna restrita, um arquivo de exportação, um e-mail de notificação ou uma linha de log não é filtrado para quem o lê.
Valores informados no início de uma execução. Qualquer pessoa que possa executar um fluxo de trabalho pode iniciá-lo com valores próprios para as variáveis dele — o App Runner faz isso com as respostas do formulário, e a API e as ferramentas de IA também podem. Esses valores valem somente para aquela execução, inclusive nos fluxos de trabalho que ela inicia com uma etapa Fluxo de trabalho: Executar: nunca são salvos no fluxo de trabalho, e nenhuma outra execução, exportação ou leitor os vê. Como a execução ocorre como a identidade de serviço, os valores podem alterar o que aquela execução lê e grava; por isso, conceda a permissão de executar fluxos de trabalho a pessoas em quem você confia.
Projetos que não restringem linhas. Estas regras só entram em vigor quando um projeto restringe uma coluna. Em um projeto que não restringe nenhuma, qualquer pessoa que possa alterar a automação do projeto pode escrever uma etapa ou uma função definida pelo usuário que — executada como a identidade de serviço do projeto — altera o acesso ao projeto, tornando a si mesma um de seus Arquitetos. Isso é intencional: esse projeto não promete isolamento de linhas. Mantenha os direitos de criação ali restritos a pessoas em quem você confiaria como Arquitetos, ou restrinja uma coluna.
Manter os painéis sincronizados
Seção intitulada “Manter os painéis sincronizados”O acesso a linhas mostra em que ponto uma alteração está a caminho dos seus painéis, na grade e na coluna Sincronizar da guia Segurança do projeto:
| Status | O que significa |
|---|---|
| Aguardando | Uma alteração foi salva e está a caminho dos painéis. Normalmente é resolvida em cerca de um minuto. |
| Tentando novamente | Um envio falhou e está sendo tentado de novo. O motivo da falha é mostrado ao lado do status, com Tentar novamente para enviar de novo imediatamente. |
| Ainda não aplicado | As restrições do projeto ainda não foram enviadas aos painéis. |
| Aplicado | A última tentativa de enviar as restrições aos painéis foi bem-sucedida. |
| Sincronizado com os painéis | O acesso a linhas comparou o que os painéis aplicam com o que ele gravaria, e os dois coincidem. |
| Os painéis diferem | Os painéis não aplicam o que o acesso a linhas gravaria — uma regra foi alterada ou excluída no Superset, ou a visão publicada de uma tabela não pode ser verificada. |
| Erro | O envio das restrições falhou. O motivo é mostrado ao lado do status. |
Quando uma alteração chega a Aplicado, a grade a confere com os painéis e passa para Sincronizado com os painéis ou Os painéis diferem. Os painéis diferem e Erro oferecem Tentar novamente, que envia novamente as restrições do projeto. Se o status não puder ser lido de forma alguma, a grade diz “Não foi possível verificar o status de sincronização.”
Um Erro causado por uma tabela nomeia a tabela e diz o que fazer — por exemplo, uma tabela publicada sem a coluna restrita (“Republique-a ou cancele a publicação.”), ou uma tabela com uma coluna restrita que não está publicada, que os painéis não conseguem filtrar até que seja. O status permanece em Erro e nomeia a tabela não publicada até que você a publique ou restrinja a coluna em uma tabela publicada. Uma tabela assim não trava o restante do projeto: todas as outras tabelas são mantidas em sincronia.
Os painéis seguem as mesmas concessões das consultas do próprio PlaidCloud:
- Toda tabela publicada com a coluna é filtrada, e não apenas a tabela que você estava vendo quando configurou a restrição.
- Um grupo que recebeu apenas alguns valores é filtrado mesmo quando todos os demais veem todas as linhas, em toda tabela cujo conjunto de dados de painel exista.
- Os Arquitetos do projeto veem todas as linhas, nos painéis assim como no Explorador de tabelas e no restante do PlaidCloud. Isso vale para os grupos de Arquitetos do projeto e para os Arquitetos de um projeto compartilhado com membros individuais. Retirar o acesso de Arquiteto tem efeito imediato nos painéis, seja alterando a função do membro, removendo o membro ou o grupo dele do projeto, alterando o tipo de acesso do projeto, restaurando uma versão anterior do projeto ou excluindo o grupo.
- As alterações de associação a grupos de segurança chegam aos painéis por conta própria. Adicionar alguém a um grupo ou removê-lo no PlaidCloud, desativar ou excluir um membro, excluir um grupo ou adicionar um novo membro que entra nos seus grupos de segurança padrão atualiza o que essas pessoas veem nos painéis em cerca de um minuto, em todos os projetos que concedem valores a esse grupo, sem que ninguém precise reabrir o acesso a linhas. Uma alteração de associação feita fora do PlaidCloud — diretamente no Keycloak, ou por logon único que coloca alguém em um grupo no login — chega aos painéis em cerca de 15 minutos, sem nada para salvar nem tentar novamente.
Concessões de dimensão
Seção intitulada “Concessões de dimensão”Com Dimensão como origem dos valores, marque um nó para conceder tudo o que está abaixo dele. A concessão acompanha a dimensão: um membro adicionado sob um nó marcado é concedido a esse grupo na próxima sincronização depois que a dimensão é salva, e um membro movido para fora dele, ou removido, deixa de ser concedido — ninguém precisa reabrir a grade. Quando você a reabre, os nós que você marcou aparecem marcados novamente.
Um membro que você marcou individualmente, e não por meio de um nó, continua concedido quando é removido da dimensão, e a grade o marca como um valor que a origem não tem mais.
Desmarcar qualquer item abaixo de um nó marcado desmarca o nó, e o grupo fica apenas com os membros que continuam marcados. Marcar esse membro de novo não marca o nó novamente — clique na caixa do próprio nó para isso. Colar, Selecionar tudo e Inverter marcam membros, nunca nós.
Um membro de dimensão cujo nome não pode ser usado como valor de acesso a linhas é recusado quando você salva, com o nome dele indicado. Se esse membro aparecer depois, as linhas dele não são concedidas a ninguém, e o status de sincronização o nomeia: “O membro ‘…’ da dimensão ‘…’ não pode ser usado como valor de acesso a linhas; portanto, as linhas dele não são concedidas. Renomeie-o na dimensão.”
Vincular concessões a uma tabela de origem
Seção intitulada “Vincular concessões a uma tabela de origem”Em vez de marcar valores manualmente, você pode apontar uma coluna restrita para uma tabela de origem que já contenha a resposta — uma linha por grupo e o valor que ele pode ver. Restrinja primeiro a coluna na grade e depois adicione uma etapa de fluxo de trabalho Definir acesso às linhas que nomeie a coluna, a tabela de origem e as colunas de grupo e de valor da tabela de origem. A primeira execução da etapa vincula a coluna a essa tabela: as concessões definidas manualmente na coluna são limpas, e as concessões dela passam a ser definidas a partir das linhas da tabela.
Depois de vinculada, a coluna passa a ser de propriedade da origem: a grade de acesso a linhas a mostra bloqueada, com uma etiqueta que nomeia a tabela de origem, e a edição manual das concessões é recusada até que você clique em Remover vinculação.
Cada execução posterior da etapa relê a tabela de origem e reaplica as concessões — agende-a depois do fluxo de trabalho que carrega ou atualiza essa tabela, e um grupo adicionado, removido ou reatribuído nos dados de origem chega ao acesso a linhas na execução seguinte, sem que ninguém edite a grade manualmente.
Como a tabela de origem decide quem vê o quê, somente um Arquiteto do projeto, um administrador do tenant ou os próprios fluxos de trabalho do projeto podem alterar as linhas dela ou excluí-la. Qualquer outra pessoa recebe a mensagem “Esta tabela fornece as concessões de acesso a linhas de ‘region’; portanto, somente um Arquiteto do projeto pode alterar as linhas dela ou excluí-la.”
Modelos de restrição
Seção intitulada “Modelos de restrição”Se você criou um formato de restrição que quer reutilizar — a mesma origem de valores, o mesmo tipo de valor e a mesma configuração de valores em branco —, salve-o uma vez e aplique-o onde for necessário, em vez de recriá-lo coluna por coluna.
- Salvar como modelo…, em uma tela de acesso a linhas aberta, salva o formato da coluna atual como um modelo nomeado, no nível do tenant. Ele salva apenas o formato — nenhuma concessão o acompanha.
- Aplicar modelo, na coluna de outro projeto, inicia essa coluna a partir do formato do modelo, com as concessões de todos os grupos vazias para você preencher.
Qualquer Arquiteto do projeto pode salvar e aplicar modelos. Renomear (Renomear…) e excluir (Excluir) um modelo exige um administrador do tenant, já que um modelo é compartilhado em todo o tenant. Excluir um modelo deixa as colunas às quais ele foi aplicado restritas como estão.
Concessões a partir de atributos de grupo do SSO
Seção intitulada “Concessões a partir de atributos de grupo do SSO”Uma coluna também pode obter as concessões do seu provedor de identidade em vez de do PlaidCloud. Um Arquiteto do projeto ativa isso em uma coluna no acesso a linhas, habilitando Aceitar concessões de acesso a linhas de atributos de grupo do SSO.
Depois de habilitado, o atributo row_access.<column> do Keycloak de um grupo de segurança define os valores que esse
grupo pode ver por meio dessa coluna — defina o atributo no grupo no Keycloak, e o PlaidCloud
o aplica automaticamente para qualquer grupo que já tenha acesso ao projeto. Não há nada
mais a configurar no próprio acesso a linhas, e as concessões permanecem sincronizadas tanto nas consultas
do próprio PlaidCloud quanto nos painéis do Superset.
Visualizar antes de salvar
Seção intitulada “Visualizar antes de salvar”O acesso a linhas mostra o que uma alteração significa antes de você confirmá-la:
- Um rodapé Visualizar como mostra quantas das linhas da tabela um grupo veria do total, com uma amostra das próprias linhas — escolha qualquer grupo da grade para visualizá-lo. A visualização é atualizada depois que você salva.
- Antes de salvar, o acesso a linhas avisa sobre qualquer coisa que mereça uma segunda olhada: um grupo sem nada marcado, e se isso significa que ele vê todas as linhas ou nenhuma, conforme a sua configuração de Todos os demais; membros com acesso ao projeto que não são cobertos pela concessão de nenhum grupo; ou linhas cujo valor nessa coluna está em branco (
NULL) e que não são concedidas a nenhum grupo.
O que um membro restrito vê
Seção intitulada “O que um membro restrito vê”Sempre que um membro restrito lê uma tabela pelo nome, ele recebe apenas as linhas dele — a grade, as facetas de coluna e os downloads do Explorador de tabelas, a caixa de diálogo de download de tabela, os aplicativos e as ferramentas que leem como o visualizador, e os painéis. O Explorador de tabelas mostra Linhas limitadas pelo seu acesso na barra de ferramentas quando a grade que você está vendo foi filtrada pelas suas concessões, e iniciar um download que será filtrado diz “Linhas limitadas pelo seu acesso.” Um Arquiteto, que lê todas as linhas, não vê nenhum dos dois avisos.
Acesso a linhas e consultas que você mesmo escreve
Seção intitulada “Acesso a linhas e consultas que você mesmo escreve”Quando o acesso a linhas limita suas linhas, você pode executar suas próprias consultas SQL nas telas de consulta do projeto e obter exatamente as linhas que suas concessões permitem. Você pode exportar os resultados para CSV, Excel ou JSON, e a exportação contém apenas essas linhas, com o aviso Linhas limitadas pelo seu acesso. Um Arquiteto do projeto lê todas as linhas, porque um Arquiteto já pode conceder a si mesmo todos os valores de todas as colunas restritas, e não vê nenhum aviso.
Um valor de concessão que contém um sinal de porcentagem (%) retorna as linhas concedidas nas telas de consulta, e baixar essa consulta como CSV funciona.
Estas ações continuam sendo recusadas para um membro que não é Arquiteto do projeto:
- Executar SQL livre próprio em um warehouse de projeto Snowflake ou Databricks.
- Exportar os resultados do seu próprio SQL de um warehouse da família Postgres.
- Exportar os resultados do seu próprio SQL para outro banco de dados.
- Digitar uma condição de linha na visualização “Test row 1” de uma etapa de distribuição.
- Ler uma tabela governada em um instantâneo anterior (viagem no tempo).
Quem é recusado é informado de qual projeto se trata e direcionado aos leitores por nome: ler uma tabela pelo nome é a forma comum de aplicativos e ferramentas lerem dados, e isso aplica as concessões e retorna as linhas a que o visualizador tem direito. Uma faceta de coluna escrita como uma consulta simples de uma única tabela também é lida pelo nome, portanto retorna os valores do próprio membro em vez de ser recusada. Um Arquiteto do projeto pode executar qualquer uma delas como escrita.
O acesso a linhas filtra uma visão pela coluna governada; portanto, uma visão precisa manter essa coluna com o nome original. Uma visão que descarta ou renomeia a coluna governada não é filtrada.
Importar uma planilha não é, por si só, uma consulta que você mesmo escreveu — uma importação comum de arquivo não lê nenhum dado restrito, ela apenas cria a nova tabela do próprio projeto a partir do arquivo que você enviou e, portanto, não é afetada pelo acesso a linhas. A exceção é uma importação cuja projeção de dados é fornecida por quem chama: uma expressão por coluna ou um mapeamento dinâmico do Excel. Na tela de importação interativa, essas são recusadas da mesma forma que as superfícies de SQL livre acima e exigem um Arquiteto do projeto, porque uma projeção fornecida por quem chama poderia ler outra tabela. Uma importação executada a partir de um fluxo de trabalho não é afetada de nenhuma forma, já que é executada sob a própria identidade de serviço do projeto.
Acesso a linhas e o Editor de dados
Seção intitulada “Acesso a linhas e o Editor de dados”O Editor de dados lê e grava uma tabela diretamente; portanto, o acesso a linhas se aplica a ele nos dois sentidos.
Abrir uma tabela restrita no Editor de dados mostra apenas as linhas concedidas ao seu grupo de segurança — o mesmo filtro que acompanha você em um painel, e ele se aplica mesmo quando a coluna restrita não é uma das colunas exibidas na grade.
Salvar suas edições exige Arquiteto no projeto. Um salvamento substitui as linhas da tabela por inteiro em vez de lê-las e não é filtrado linha a linha; por isso, editar dados em uma tabela restrita é tratado como uma ação de criação, e não de leitura: quem não é Arquiteto é informado de que precisa ser. Uma tabela sem coluna restrita é editada como antes, assim como qualquer projeto que não restringe linhas.
Carregar dados em uma tabela restrita
Seção intitulada “Carregar dados em uma tabela restrita”Quando o acesso a linhas limita as linhas que você vê, gravar um DataFrame em uma tabela restrita ou limpá-la com o cliente Python (PlaidConnection), ou salvar registros nela ou limpá-la pela API REST, funciona somente nas suas próprias linhas. Substituir os dados da tabela substitui apenas as linhas que você pode ver, limpá-la limpa apenas essas linhas, e anexar adiciona linhas; todas as outras linhas permanecem como estão.
Uma carga que contém uma linha fora do seu acesso é recusada antes que qualquer coisa mude, e o erro nomeia cada valor fora do seu acesso com quantas linhas o contêm. Uma linha que omite a coluna restrita é verificada como em branco nessa coluna; portanto, é recusada, a menos que o seu acesso inclua linhas em branco. Substituir os dados de uma forma que alteraria o tipo de uma coluna também é recusado; peça a um Arquiteto do projeto que faça essa alteração.
Arquitetos do projeto, membros cujas concessões cobrem todas as linhas e execuções de fluxo de trabalho, que são executadas como a identidade de serviço do projeto, gravam a tabela inteira. Uma tabela sem coluna restrita não é afetada.
Qualquer outra ação que substitua ou remova uma tabela restrita inteira é recusada enquanto a tabela contiver uma linha que você não consegue ver, e nada é alterado: importar um arquivo nela, copiar uma tabela de outro projeto para ela, trocar ou mesclar o branch dela, restaurá-la a partir de um arquivo compactado ou como parte da restauração dos instantâneos retidos do projeto, excluí-la, trazê-la de volta depois de excluída e qualquer outra ação que esvazie a tabela antes de preenchê-la novamente. Uma linha cuja coluna restrita está em branco conta como uma linha que você não consegue ver, a menos que o seu acesso inclua linhas em branco. Uma tabela cujas linhas você vê todas, como uma que você criou contendo apenas as suas próprias linhas, pode ser substituída ou excluída.
Cada uma dessas gravações feitas por uma pessoa, em qualquer tabela, é registrada no Log de segurança, inclusive as que foram recusadas. As execuções de fluxo de trabalho não são registradas ali.
Carregar uma dimensão a partir de uma tabela lê todas as linhas da tabela, e todas as pessoas do projeto veem os membros que ela cria. Por isso, ela só é executada para quem pode ler todas as linhas da tabela de origem: um Arquiteto do projeto, um membro cujas concessões cobrem todas as linhas ou uma execução de fluxo de trabalho. Uma dimensão que uma coluna restrita lê continua exigindo um Arquiteto do projeto, um administrador do tenant ou uma execução de fluxo de trabalho, como descrito em Quem pode alterar um projeto que restringe linhas. Uma tabela sem coluna restrita não é afetada. Qualquer outra pessoa é recusada e orientada a pedir a um Arquiteto do projeto que faça a carga ou a faça a partir de um fluxo de trabalho.
Contagens de linhas e tamanhos das tabelas
Seção intitulada “Contagens de linhas e tamanhos das tabelas”A contagem de linhas e o tamanho de armazenamento de uma tabela descrevem a tabela inteira, e não as linhas que você pode ver; assim, eles diriam a um leitor restrito quantas linhas existem além da concessão dele. Em um projeto que restringe linhas, quem tem as leituras filtradas não vê contagem de linhas nem tamanho de nenhuma tabela do projeto — em listas de tabelas, na pesquisa, nos detalhes das tabelas e nos instantâneos, e por meio do assistente de IA e das ferramentas de IA conectadas por MCP. Isso abrange todas as tabelas do projeto, inclusive as que não têm coluna restrita. Os totais do próprio projeto também ficam ocultos para essas pessoas — a contagem total de linhas e o tamanho em Início, nas listas de projetos e na pesquisa, e nos detalhes do projeto.
O mesmo vale para o histórico de execuções de fluxos de trabalho. As linhas lidas e gravadas que cada execução e cada etapa registraram também descrevem a tabela inteira; portanto, para os mesmos leitores esses números ficam em branco — no histórico de execuções de um fluxo de trabalho e de uma etapa, e por meio do assistente de IA e das ferramentas de IA conectadas por MCP. Para eles, o Weave não verifica nas etapas se há linhas ou valores vazios diferentes de execuções anteriores, já que uma constatação diria a eles que a contagem da tabela inteira mudou.
Os Arquitetos do projeto veem os números como antes, assim como todas as pessoas em um projeto que não restringe linhas.
Ver o que um membro consegue ver
Seção intitulada “Ver o que um membro consegue ver”Para verificar o que uma pessoa específica consegue ver, e não o que um grupo recebe: abra Identity → Member, selecione o membro e abra a guia Acesso a linhas dele. A coluna Acesso efetivo lista, para cada projeto e coluna restritos, os valores que esse membro vê por meio de todos os seus grupos combinados — inclusive as concessões de atributos de grupo do SSO e as linhas em branco (NULL) quando a concessão de um grupo as inclui. Um Arquiteto do projeto aparece como Vê todas as linhas (Arquiteto), já que um Arquiteto lê todas as linhas. É a mesma resposta que as próprias consultas do PlaidCloud aplicam; portanto, é útil para o suporte e para confirmar que uma alteração fez o que você queria antes que alguém relate um problema.
Erros mais claros
Seção intitulada “Erros mais claros”Quando o acesso a linhas bloqueia uma ação — uma consulta que você mesmo escreveu em um projeto restrito, uma edição sem ser Arquiteto, uma alteração de automação, de uma dimensão ou de uma tabela de origem de concessões, e os outros casos descritos acima —, a mensagem nomeia o que está restrito e o que fazer em seguida, como os Arquitetos a quem pedir, em vez de uma falha genérica.
O acesso a linhas é auditado
Seção intitulada “O acesso a linhas é auditado”Restringir ou remover a restrição de uma coluna e editar as concessões de um grupo gravam uma entrada no Log do projeto — quem fez a alteração e quando. Abra Analyze → Projects → Log no projeto para vê-lo. Nada no acesso a linhas precisa ser ativado para ter esse histórico; ele é registrado da mesma forma que qualquer outra alteração rastreada em um projeto.
Definir grupos de segurança padrão
Seção intitulada “Definir grupos de segurança padrão”Para reduzir o tempo necessário para adicionar novos membros, identifique um conjunto de grupos de segurança padrão. Isso oferece um conjunto básico de grupos de segurança para novos membros, sem a necessidade de atribuir cada pessoa manualmente. A configuração fica disponível ao adicionar um novo grupo de segurança, se você marcar a caixa na parte inferior da janela Grupo de segurança que diz “Assign to New Users by Default”.
Realizar uma auditoria de segurança
Seção intitulada “Realizar uma auditoria de segurança”O recurso de auditoria de segurança permite ver a associação a grupos de todos os membros e grupos.
Para realizar uma auditoria de segurança:
- Abra o Identity
- Selecione Auditoria de grupos em Segurança na barra lateral
Como todas as tabelas do PlaidCloud podem ser exportadas em formato CSV, as associações entre grupos e membros podem ser revisadas fora do PlaidCloud, para fins históricos ou apenas para uma divertida visualização off-line.
Para exportar a partir do formulário “Security Group Audit”:
- Abra o Identity
- Selecione Auditoria de grupos em Segurança na barra lateral
- Clique no pequeno ícone no extremo direito de “Username” na tabela
- Clique em “Export CSV” ou “Export XLXS”, conforme a sua preferência
Ver as configurações de permissão disponíveis
Seção intitulada “Ver as configurações de permissão disponíveis”Cada aplicativo usado no espaço de trabalho tem permissões específicas disponíveis. As permissões dos grupos de segurança se baseiam nessas permissões dos aplicativos.
A lista completa de permissões disponíveis para cada aplicativo pode ser vista no Security Bin.
Para acessar o Security Bin:
- Abra o Identity
- Selecione “Security”
- Clique em “Security Bins” no menu suspenso
Para ver as configurações de segurança detalhadas de cada aplicativo, selecione o ícone de tags no extremo esquerdo.
Estas informações sobre as configurações de segurança disponíveis são apenas informativas. Para obter detalhes sobre como gerenciar permissões, consulte a seção Gerenciar grupos de segurança acima.