Canvas 26 Don’t wait for the recap. Catch Miro’s latest launches from the Canvas 26 keynote, streaming live on May 19. Register now →
Deutsch English (United States) Español Français 日本語 한국어(대한민국) Polski (Polska)

Artigos nessa seção

Configurar Conectores da Miro para Okta Workflows

  • Atualizado

Conectores da Miro para Okta Workflows permitem automatizar com facilidade tarefas de admin repetitivas e de múltiplas etapas na Miro. Aprenda a configurar a automação de fluxo de trabalho e a simplificar o gerenciamento de times e usuários.

Relevante para: plano Enterprise

Conector de gerenciamento de usuários da Miro

O Conector de gerenciamento de usuários da Miro permite que clientes Enterprise da Miro com SCIM ativado adicionem usuários à organização e gerenciem licenças e status dos usuários.

Autorizar o Conector de Gerenciamento de Usuários da Miro:

Ao adicionar um cartão do Conector de Gerenciamento de Usuários da Miro a um fluxo pela primeira vez, será solicitado que você configure uma conexão para sua organização. Veja Autorização.

Cartões de ação do Conector de Gerenciamento de Usuários da Miro:

 Ação  Descrição
 Criar usuário  Cria um novo usuário.
 Pesquisar usuário  Pesquisar um usuário existente em uma organização pelo e-mail.
 Atualizar tipo de licença do usuário para Full  Atualiza um recurso de usuário existente, alterando seu tipo de licença do usuário para Full.
 Atualizar status do usuário  Atualiza um recurso de usuário existente, alterando seu status ativo para true ou false.O conector Miro User Management funciona usando seu token SCIM. O Miro User Management está disponível apenas para empresas com SSO e SCIM ativados. 


Autorização

Você pode criar e gerenciar várias conexões na Conexões página.
Isso é útil se você pretende operar com várias organizações. Cada conexão do Conector de Gerenciamento de Usuários da Miro pode apontar para apenas uma organização da Miro.

Para ativar o SCIM e obter um novo token, ou para copiar um token existente, siga as instruções em Como ativar o SCIM.
Para criar uma nova conexão a partir de um cartão de ação:

  1. Clique em Nova conexão.
  2. Informe um apelido da conexão. Recomendamos um nome que represente a organização.
  3. Ative o provisionamento SCIM na página de integração Enterprise da Miro, seguindo as instruções.
    1. Copie Base URL da Miro e cole-o no campo Base URL da conexão
    2. Copie Api Token da Miro e cole-o no campo Access Token da conexão
  4. Clique em Criar. Isso salva sua conexão e leva você de volta ao seu fluxo.

Criar usuário

Cria um usuário na organização.
 

Entrada

 Campo  Definição  Tipo  Obrigatório 
 Detalhes do usuário      
 E-mail  O endereço de e-mail do usuário.   Texto  VERDADEIRO
 Ativo

 O status do usuário.

  • True: o usuário está ativo.
  • False: o usuário está inativo.

 Quando não especificado, assume o valor false.

  Menu suspenso  FALSO
 Tipo de licença do usuário

 O tipo de licença do usuário.

  • Completa
  • Gratuita

 Quando não especificado, a licença do usuário é definida de acordo com a lógica interna da Miro, que depende do plano da organização.

  Menu suspenso  FALSO
 Função

 A função do usuário na organização.

  • Membro da organização: membro regular sem privilégios de admin.
  • Admin da organização: usuário com privilégios de admin em toda a organização.

 Quando não especificado, o padrão é Membro da organização.

  Menu suspenso  FALSO
 Nome      
 Sobrenome  O sobrenome do usuário.  String  FALSE
 Nome  O nome do usuário.  String  FALSO
 Nome exibido  O nome que será exibido na Miro.  String  FALSE

Resultado

 Campo  Definição  Tipo
Usuário    
ID do usuário  O ID do novo usuário. String


Consultar usuário

Pesquisar um usuário existente em uma organização por e-mail

Entrada

 Campo  Definição  Tipo  Obrigatório 
Consulta      
 E-mail O endereço de e-mail do usuário a ser pesquisado  String  TRUE

Resultado

 Campo  Definição  Tipo
 Usuário    
 ID do usuário O ID do usuário. Número
 Tipo de licença do usuário O tipo de licença do usuário. Número
 Ativo

O status do usuário.

  • True: o usuário está ativo.
  • False: o usuário está inativo.
Número
 Nome    
 Nome de usuário O endereço de e-mail do usuário.  Número
 Sobrenome O sobrenome do usuário. Número
 Nome O nome do usuário. Número
 Nome exibido O nome exibido na Miro. Número


Atualizar tipo de licença do usuário para Full

Atualiza um recurso de usuário existente, alterando seu tipo de usuário (licença) para Full.

Entrada

 Campo  Definição  Tipo  Obrigatório 
Usuário      
 ID do usuário  O ID do usuário. String TRUE

Resultado

 Campo  Definição  Tipo
Resposta    
 Código de status

 Status HTTP da solicitação.
 Códigos que indicam atualização de licença bem-sucedida:

  • 200: OK

 Códigos que indicam atualização de licença sem sucesso:

  • 400: Solicitação malformada
  • 401: Não autorizado
  • 403: Proibido
  • 404: Não encontrado
  • 409: Conflito
  • 429: Muitas requisições
 Número  


Atualizar status do usuário

Atualiza um recurso de usuário existente, alterando seu status ativo para true ou false.

Entrada

 Campo  Definição  Tipo  Obrigatório  
Usuário      
 ID do usuário  O ID do usuário.  String  TRUE
 Ativo

 O novo status do usuário.

  • True: o usuário está ativo.
  • False: o usuário está inativo.

     
  Menu suspenso  TRUE

 Resultado

 Campo  Definição  Tipo
 Resposta    
 Código de status 

 Status HTTP da solicitação.
 Códigos que indicam atualização bem-sucedida do status ativo:

  • 200: OK

 Códigos que indicam atualização do status ativo com falha:

  • 400: Solicitação malformada
  • 401: Não autorizado
  • 403: Proibido
  • 404: Não encontrado
  • 409: Conflito
  • 429: Muitas solicitações
 Número


Conector de administração da Miro

O Conector de administração da Miro permite que clientes Enterprise criem times e gerenciem as configurações e os membros desses times.

Autorizar o Conector de administração da Miro:

Ao adicionar um cartão da Miro a um fluxo pela primeira vez, você será solicitado a configurar uma conexão para sua organização. Consulte Autorização.

Miro Administration Connector cartões de ação:

 Ação  Descrição
 Criar time  Cria um novo time em uma organização existente.
 Pesquisar times Pesquisa times existentes em uma organização. Os primeiros 10 registros correspondentes são selecionados do conjunto de resultados.
 Adicionar membro ao time  Adiciona um novo membro a um time existente.
 Atualizar função de membro do time  Atualiza a função de um membro em um time existente.
 Obter configurações do time  Recupera as configurações de um time existente.
 Atualizar configurações de políticas de compartilhamento do time  Atualiza as configurações da política de compartilhamento de um time existente.
 Atualizar configurações da política de convite do time  Atualiza as configurações da política de convite de um time existente.
 Atualizar configurações de colaboração do time  Atualiza as configurações da política de colaboração de um   time existente.
 Atualizar configurações de visibilidade do time  Atualiza as configurações da política de visibilidade de um   time existente.
 Atualizar configurações de acesso à cópia do time  Atualiza as configurações da política de acesso à cópia de um   time existente.
Limpar sessões de usuário (Beta) Limpa todas as sessões do usuário para um determinado endereço de e-mail.

 

Autorização

O Conector de Administração da Miro funciona usando token de API OAuth. O Conector de Administração da Miro está disponível apenas para clientes no plano Enterprise. Para criar uma nova conexão, os usuários precisam ter as permissões necessárias para instalar apps com os escopos suportados abaixo.

Você pode criar e gerenciar várias conexões na página Connections.
Isso é útil se você planeja operar com várias organizações. Cada conexão do Conector de Administração da Miro pode apontar para apenas uma Organização da Miro.

Para criar uma nova conexão a partir de um cartão de ação:

  1. Clique em Nova conexão.
  2. Informe um Nome da conexão. Recomendamos um nome que represente a organização.
  3. Obtenha ID da organização e Token de acesso na página de integração Enterprise da Miro, seguindo as instruções.
  4. Clique em Criar. Isso salva sua conexão e retorna ao seu fluxo.

Escopos compatíveis:

  • organizations:teams:write
  • organizations:teams:read

Criar time

Cria um time em uma organização existente.

Entrada

Campo Definição Tipo   Obrigatório  
Time   
 Nome do time   Nome do time.    String  TRUE

Resultado

 Campo  Definição  Tipo
Resposta
 ID do time  O ID do novo time.  String

 

Pesquisar times

Pesquisar times existentes em uma organização. Os primeiros 10 registros correspondentes são selecionados do conjunto de resultados.

Entrada

 Campo  Definição  Tipo  Obrigatório  
Consulta    
Nome do time Palavras que serão buscadas no nome do time. Qualquer time cujo nome contenha essas palavras exatas será retornado no conjunto de resultados. Times com nomes que correspondam exatamente à consulta aparecerão no topo dos resultados.  String  FALSO

Saída

 Campo  Definição   Tipo
Resposta    
Times Lista com os 10 primeiros times encontrados. Cada time possui os campos abaixo.  Lista  
ID do time ID do time  String
Nome Nome do time  String

 

Adicionar membro ao time

Adiciona um novo membro a um time existente.

Entrada

  Campo  Definição  Tipo  Obrigatório  
Time    
 ID do time  O ID do time.  String    TRUE
Membro  
 E-mail do usuário    O e-mail do usuário que você deseja adicionar ao time.    String  TRUE

Resultado

 Campo  Definição   Tipo
Resposta    
 ID do membro    O ID do novo membro do time.   String  


Atualizar função do membro do time

Atualiza a função de um membro em um time existente.

Entrada

 Campo  Definição  Tipo  Obrigatório  
Time      
 ID do time  O ID do time.  String  VERDADEIRO
Membro    
 ID do membro  O ID do membro do time.  String  TRUE
 Função

 A nova função do membro no time.

  • Membro: membro regular.
  • admin: membro com privilégios de admin no time.
  • Convidado do time: convidado com privilégios limitados.

     
  Menu suspenso    Verdadeiro

Resultado

 Campo  Definição  Tipo     
Resposta    
 ID do membro    O ID do membro do time.  String
 Função

 A nova função atribuída ao membro do time.

  • membro: membro regular.
  • admin: membro com privilégios de admin dentro do time.  
  • convidado: convidado com privilégios limitados.
 String

 

Obter configurações do time

Recupera as configurações de um time existente.

Entrada

Campo Definição Tipo  Obrigatório 
Time     
 ID do time   O ID do time.   String  TRUE

Saída

 Campo   Definição  Tipo
Configurações de convite   do time    
 Quem pode convidar
  • only_org_admins: somente Admins da empresa podem convidar colaboradores.
  • admins: Admins da empresa e admins do time podem convidar colaboradores.
  • all_members: todos os membros do time podem convidar colaboradores.
 String
 Convidar usuários externos
  • allowed: permitir colaboradores que não sejam membros do time.
  • Not_allowed: não permitir colaboradores que não sejam membros do time.
 String
Configurações de colaboração   do time    
 Função cotitular
  • enabled: Ativar função cotitular em boards e projetos.
  • disabled: Desabilitar função cotitular em boards e projetos.
 String
 Configurações de nível de acesso à cópia do time    
 Nível de acesso à cópia
  • anyone: qualquer pessoa com acesso ao board pode copiar o conteúdo existente do board para boards recém-criados.
    AVISO: esta opção está disponível apenas se Limitação do nível de acesso à cópia estiver definida como anyone.
  • team_members: membros do time podem copiar o conteúdo existente do board para boards recém-criados.
  • team_editors: membros do time com permissão de edição podem copiar o conteúdo existente do board para boards recém-criados.
  • board_owner: apenas os titulares do board podem copiar o conteúdo existente do board para boards recém-criados.
 String
 Nível de acesso de cópia   limitação
  • anyone: membros do time e usuários fora do time podem receber permissão para copiar conteúdo do board.
  • team_members: apenas membros do time podem receber permissão para copiar conteúdo do board.
 String
Configurações de visibilidade do time    
 Visibilidade
  • oculto: Somente usuários convidados podem ver e acessar o time.
  • solicitação: membros da organização podem encontrar o time e solicitar participar dele com aprovação do admin.
  • entrar: membros da organização podem encontrar e entrar no time.
 String
 Configurações da política de compartilhamento do time    
 Acesso padrão ao board
  • privado: apenas titulares de boards podem acessá-los.
  • visualizar: qualquer pessoa no time pode visualizar boards.
  • comentar: qualquer pessoa no time pode comentar nos boards.
  • editar: qualquer pessoa no time pode editar boards.
 String
 Acesso padrão da organização 
  • privado: apenas titulares de boards podem acessar os boards.
  • visualizar: qualquer pessoa na organização pode visualizar boards.
  • comentar: qualquer pessoa na organização pode comentar nos boards. 
  • editar: qualquer pessoa na organização pode editar os boards.
 Texto 

 Compartilhamento na organização

 
  •  
    • allowed: permitir compartilhamento no nível da organização.
  • allowed_with_editing: permitir compartilhamento com direitos de edição no nível da organização.
  • not_allowed: não permitir compartilhamento no nível da organização.
 String
 Compartilhamento no time
  •  
    • allowed: permitir compartilhamento no nível do time.
  • allowed_with_editing: permitir compartilhamento com direitos de edição no nível do time.
  • not_allowed: não permitir compartilhamento no nível do time.
 String
 Compartilhamento por link   público
  • allowed: permitir compartilhamento por link público.
  • allowed_with_editing: permitir compartilhamento por link público com direitos de edição.
  • not_allowed: não permitir compartilhamento por link público.
 String
 Mover board para o time
  • allowed: permitir mover boards para um time diferente.
  • not_allowed: não permitir mover boards para um time diferente.
 String

 

Atualizar configurações da política de compartilhamento do time

Atualiza as configurações da política de compartilhamento de um time existente.

Entrada

 Campo  Definição  Tipo  Obrigatório 
Time      
 ID do time  O ID do time.  String  TRUE
 Acesso padrão do   board
  • Privado: apenas titulares de boards podem acessar boards.
  • Visualizar: qualquer pessoa no time pode visualizar boards.
  • Comentar: qualquer pessoa no time pode adicionar comentários aos boards.
  • Editar: qualquer pessoa no time pode editar boards.
 Menu suspenso   FALSO
 Acesso padrão   da organização
  • Privado: apenas titulares de boards podem acessá-los.
  • Visualizar: qualquer pessoa no time pode visualizar boards.
  • Comentar: qualquer pessoa no time pode comentar nos boards.
  • Editar: qualquer pessoa no time pode editar boards.
 Menu suspenso  FALSO
 Compartilhamento por link   público
  • Permitido: permitir o compartilhamento por link público.
  • Permitido com edição: permitir o compartilhamento com permissão para editar por link público.
  • Não permitido: não permitir o compartilhamento por link público.
 Menu suspenso  FALSO
 Compartilhamento no time
  • Permitido: permitir compartilhamento no nível do time.
  • Permitido com edição: permitir compartilhamento com permissão para editar no nível do time.
  • Não permitido: não permitir compartilhamento no nível do time.
 Menu suspenso  FALSO

 Compartilhamento na  organização

 
  • Permitido: permitir compartilhamento no nível da organização.
  • Permitido com edição: permitir compartilhamento com direito de edição no nível da organização.
  • Não permitido: não permitir compartilhamento no nível da organização.
 Menu suspenso  FALSO
 Mover board para o time
  • Permitido permitir mover boards para um time diferente.
  • Não permitido não permitir mover boards para um time diferente.
 Menu suspenso  FALSO

Saída

 Campo  Definição  Tipo
 Configurações da política de compartilhamento do time  
 Acesso padrão ao board
  • privado: Apenas titulares de boards podem acessar.
  • visualizar: Qualquer pessoa no time pode visualizar boards.
  • comentar: Qualquer pessoa no time pode comentar nos boards.
  • editar: Qualquer pessoa no time pode editar boards.
 String  
 Acesso padrão da organização
  • privado: apenas titulares de boards podem acessar boards.
  • visualizar: qualquer pessoa na organização pode visualizar boards.
  • comentar: qualquer pessoa na organização pode comentar nos boards.
  • editar: qualquer pessoa na organização pode editar boards.
 String

 Compartilhamento na organização

 
  •  
    • permitido: permite o compartilhamento no nível da organização.
  • permitido_com_edição: permite o compartilhamento com permissão de edição no nível da organização.
  • não_permitido: não permite o compartilhamento no nível da organização.
 String
 Compartilhamento no time
  •  
    • allowed: permitir compartilhamento no nível do time.
  • allowed_with_editing: permitir compartilhamento com direito de edição no nível do time.
  • not_allowed: não permitir compartilhamento no nível do time.
 String
 Compartilhamento por link público
  •  
    • allowed: permitir compartilhamento por link público.
  • allowed_with_editing: permitir compartilhamento por link público com permissão para editar.
  • not_allowed: não permitir compartilhamento por link público.
 String
 Mover board para o time
  • allowed: permitir mover boards para um time diferente.
  • not_allowed: não permitir mover boards para um time diferente.
 String

 

Atualizar configurações de convite do time

Atualiza as configurações da política de convite de um time existente.

Entrada

 Campo  Definição  Tipo  Obrigatório 
Time      
 ID do time  O ID do time.  String  TRUE
 Convidar usuários externos
  • Permitido: permitir colaboradores que não são membros do time.
  • Não permitido: não permitir colaboradores que não são membros do time.
 Lista suspensa   FALSE
 Quem pode convidar
  • Apenas Admins da empresa: apenas admins da empresa podem convidar colaboradores.
  • Admins: admins da empresa e admins do time podem convidar colaboradores.
  • Todos os membros: todos os membros do time podem convidar colaboradores.
 Menu suspenso  FALSO

Resultado

 Campo  Definição  Tipo
Configurações de convite do time    
 Convidar usuários externos   
  • allowed: permitir colaboradores que não sejam membros do time.
  • Not_allowed: não permitir colaboradores que não sejam membros do time.
 String  
 Quem pode convidar
  • only_org_admins: somente Admins da empresa podem convidar colaboradores.
  • admins: Admins da empresa e admins do time podem convidar colaboradores.
  • all_members: todos os membros do time podem convidar colaboradores.
 String

 

Atualizar configurações de acesso à cópia do time

Atualiza as configurações da política de acesso à cópia de um time existente.

Entrada

 Campo  Definição  Tipo  Obrigatório 
Time      
 ID do time  O ID do time.  String  TRUE
 Nível de acesso à cópia
  • anyone: qualquer pessoa com acesso ao board pode copiar o conteúdo existente do board para boards recém-criados.
  • Team Members: membros do time podem copiar o conteúdo existente do board para boards recém-criados.
  • Team Editors: membros do time com permissão para editar podem copiar o conteúdo existente do board para boards recém-criados.
  • Titular do board: apenas os titulares do board podem copiar o conteúdo existente do board para boards recém-criados.
 Menu suspenso   FALSE
 Acesso de cópia   Limitação de nível
  • Membros do time e usuários fora do time: membros do time e usuários fora do time podem receber permissão para copiar conteúdo do board.
  • Membros do time: apenas membros do time podem receber permissão para copiar conteúdo do board.
 Dropdown  FALSE

Resultado

 Campo  Definição  Tipo
Configurações de acesso à cópia do time    
 Nível de acesso à cópia
  • anyone: qualquer pessoa com acesso ao board pode copiar o conteúdo existente para boards recém-criados.
  • team_members: membros do time podem copiar o conteúdo existente para boards recém-criados.
  • team_editors: membros do time com permissão para editar podem copiar o conteúdo existente para boards recém-criados.
  • board_owner: somente os titulares do board podem copiar o conteúdo existente do board para boards recém-criados.
 String
 Limitação do nível de acesso para cópia
  • anyone: membros do time e usuários fora do time podem receber permissão para copiar conteúdo do board.
  • team_members: apenas membros do time podem receber permissão para copiar conteúdo do board.
 String

 

Atualizar configurações de colaboração do time

Atualiza as configurações da política de colaboração de um time existente.

Entrada

 Campo  Definição  Tipo  Obrigatório 
Time      
 ID do time O ID do time. String TRUE
 Cotitular   Função
  • Ativado: ativar a função de cotitular em boards e projetos.
  • Desabilitado: desabilitar a função de cotitular em boards e projetos.
 Menu suspenso   FALSE

Resultado

 Campo  Definição  Tipo
Configurações de colaboração do time    
 Função de cotitular
  • ativado: ativar a função de cotitular em boards e projetos.
  • desativado: desativar a função de cotitular em boards e projetos.
 String

 

Atualizar configurações de visibilidade do time

Atualiza as configurações da política de descoberta de um time existente.

Entrada

 Campo  Definição  Tipo  Obrigatório 
Time      
 ID do time  O ID do time.  String  TRUE
 Visibilidade
  • Oculto: Somente usuários convidados podem ver e acessar o time.
  • Solicitar: Membros da organização podem encontrar e solicitar para participar do time com aprovação do admin.
  • Entrar: Membros da organização podem encontrar e entrar no time.
 Lista suspensa   FALSO

Resultado

 Campo  Definição  Tipo
Configurações de visibilidade do time    
 Visibilidade
  • hidden: Somente usuários convidados podem ver e acessar o time.
  • request: Membros da organização podem encontrar o time e solicitar participação, mediante aprovação do admin.
  • join: Membros da organização podem encontrar e entrar no time.
 String

 

Limpar sessões do usuário

Limpa todas as sessões do usuário associadas a um endereço de e-mail.

Entrada

 Campo  Definição  Tipo  Obrigatório  
Detalhes do usuário      
 E-mail O endereço de e-mail do usuário cujas sessões serão encerradas.  String  TRUE

Resultado

 Campo  Definição  Tipo
 Resposta    
 Código de status 

 Status HTTP da solicitação.
 Códigos que indicam que a exclusão da sessão do usuário foi bem-sucedida:

  • 200: Sessão do usuário excluída

 Códigos que indicam falha na exclusão da sessão do usuário:

  • 400: Solicitação malformada
  • 401: Não autorizado
  • 403: Proibido
  • 404: Não encontrado
  • 409: Conflito
  • 429: Muitas solicitações
 Número 
Este artigo foi útil?
Sim, eu agradeço Não muito
Ah, que pena! Pedimos desculpas. Por que o artigo não foi útil?
If you would like to get a reply from the Miro Support team, please create a ticket here
Thank you for your feedback!
Error! Please try later...
Voltar ao topo

Artigos relacionados