Gerenciamento de permissões de usuário

Este guia explica como gerenciar permissões de usuário com a API Frame.io V4. Ele aborda como as permissões funcionam nos níveis de Conta, Espaço de trabalho e Projeto, e quais pontos de acesso usar em cada um.

Níveis de permissão

As permissões no Frame.io são gerenciadas nos níveis de Conta, Espaço de trabalho e Projeto. Cada nível usa seu próprio conjunto de funções:

Account 
│
├── (admin)  - full access to all Workspaces, Projects, and Restricted Projects
│
└── (member)
        │
        ├── Workspace - (full_access | editor | edit_only | commenter | viewer)
        │       │
        │       └── Project - (full_access | editor | edit_only | commenter | viewer)
        │
        └── Restricted Project - (members require direct invite)

Todo usuário tem uma função de conta. Pela API, você pode definir a função de um usuário como administrador ou membro.

Administradores da conta têm acesso total a todos os Espaços de trabalho e Projetos. Membros da conta podem ser adicionados seletivamente aos Espaços de trabalho e Projetos necessários.

Ao adicionar um Membro da conta a um Espaço de trabalho, o nível de permissão atribuído (full_access, editor, edit_only, commenter ou viewer) se aplica a todos os Projetos existentes e futuros dentro dele. Por exemplo, se você adicionar um membro de conta como visualizador, ele terá permissões de visualizador sempre que acessar qualquer Projeto nesse Espaço de trabalho. Esse mesmo Membro da conta pode ser adicionado a um Projeto específico dentro desse Espaço de trabalho como editor. Como resultado, sempre que acessar esse Projeto, ele terá permissões de editor. As permissões de visualizador continuam sendo aplicadas a todos os outros Projetos nesse Espaço de trabalho. Como as atribuições de Projeto são separadas das atribuições de Espaço de trabalho, se você remover esse Membro da conta do Espaço de trabalho, ele manterá as permissões de editor para esse único Projeto.

Projetos restritos são a exceção. Membros da conta sempre exigem um convite direto. Veja mais detalhes sobre isso na seção Permissões no nível do projeto abaixo.

Permissões de nível de conta

Todo usuário na sua Conta tem uma função:

Administradores da conta têm acesso total em todos os lugares. Para limitar o acesso de um Administrador a recursos específicos, primeiro altere sua função de conta para Membro e depois adicione-o aos Espaços de trabalho ou Projetos necessários.

Por exemplo:

$
curl https://api.frame.io/v4/accounts/:account_id/users \
>
     -H "Authorization: Bearer <token>"

$
curl -X PATCH https://api.frame.io/v4/accounts/:account_id/users/:user_id \
>
     -H "Authorization: Bearer <token>" \
>
     -H "Content-Type: application/json" \
>
     -d '{
>
  "data": {
>
    "role": "member"
>
  }
>
}'

$
curl -X PATCH https://api.frame.io/v4/accounts/:account_id/projects/:project_id/users/:user_id \
>
     -H "Authorization: Bearer <token>" \
>
     -H "Content-Type: application/json" \
>
     -d '{
>
  "data": {
>
    "role": "edit_only"
>
  }
>
}'

Pontos de acesso de permissões da conta

Permissões no nível do Espaço de trabalho

Ao adicionar um Membro da conta a um Espaço de trabalho, ele terá esse nível de permissão em todos os Projetos dentro dele. Os Espaços de trabalho são somente por convite, portanto Membros da conta veem apenas os Espaços de trabalho aos quais foram adicionados.

Pontos de acesso de permissões do Espaço de trabalho

Permissões no nível do Projeto

Projetos usam os mesmos níveis de permissão que Espaços de trabalho. Adicione um usuário diretamente a um Projeto quando ele precisar de acesso somente a esse Projeto específico ou quando precisar de um nível de permissão diferente da atribuição no Espaço de trabalho. Os usuários não precisam de acesso ao Espaço de trabalho para serem adicionados a um Projeto.

$
curl -X PATCH https://api.frame.io/v4/accounts/:account_id/projects/:project_id/users/:user_id \
>
     -H "Authorization: Bearer <token>" \
>
     -H "Content-Type: application/json" \
>
     -d '{
>
  "data": {
>
    "role": "full_access"
>
  }
>
}'

Projetos restritos

Projetos restritos exigem um convite direto. O acesso ao Espaço de trabalho não é transferido,

portanto os usuários só podem acessar um Projeto restrito se tiverem sido adicionados diretamente a ele.

Para conceder acesso a um Membro, adicione-o ao Projeto com o nível de permissão apropriado.

Pontos de acesso de permissões do Projeto

Recursos

Recursos adicionais que podem ser úteis:

• O fórum do desenvolvedor do Frame.io é onde desenvolvedores podem fazer perguntas, compartilhar feedback e discutir o que estão criando
• Artigo da Central de ajuda sobre Funções e permissões de usuário
• A Folha de referência de autorização da OWASP, para informações adicionais sobre controle de acesso baseado em relacionamento e atributos