# Como levo os meus usuários atuais para a Didit?

Source: https://help.didit.me/pt-BR/authentication/import-users-from-another-platform
Updated: 2026-11-12

Importe usuários de outra plataforma de identidade com senhas, e-mails verificados e vínculos sociais, sem novo cadastro. Faça uma simulação e depois importe.

Abra **Autenticação → Importar usuários** em uma aplicação em Produção, clique em **Nova importação**, envie um arquivo CSV ou JSON, rode uma **Simulação** e depois clique em **Iniciar importação**. As pessoas mantêm a senha, o e-mail verificado, os vínculos sociais, os apps autenticadores e os seus IDs de usuário, e nada muda para elas até o seu app fazer o login delas com a Didit.

![A página Importar usuários no console da Didit, com o botão Nova importação e o histórico de importações](https://help.didit.me/screenshots/auth-import-users-light.webp)

*Importar usuários: inicie uma nova importação e acompanhe cada uma no histórico de importações.*

Você pode trazer pessoas de outra plataforma de identidade, como Auth0, Clerk ou Firebase, do seu próprio banco de dados, ou de qualquer exportação em CSV ou JSON. A página **Importar usuários** aparece apenas em aplicações em Produção e abre com o título **Migração**.

## O que uma importação pode manter

| Mantido | Observações |
|---|---|
| Hashes de senha | Ative **Importar hashes de senhas**. Caso contrário, escolha **Precisam de uma nova senha**. |
| E-mails verificados | **Manter emails verificados**: as pessoas não confirmam o e-mail de novo. |
| Vínculos de login social | **Manter vínculos de login social**: as contas de provedores compatíveis continuam vinculadas. |
| Apps autenticadores | **Manter aplicativos autenticadores**. |
| Seus IDs de usuário | **Manter seus IDs de usuário**: os IDs que ligam o seu banco de dados a esses usuários. |
| Funções na organização | As pessoas mantêm a função delas na organização. |

Chaves de acesso não podem ser importadas. Uma chave de acesso pertence ao domínio em que foi criada, que é o seu domínio antigo, então as pessoas adicionam uma nova chave de acesso depois de fazer login.

Se o formato da senha de uma pessoa não puder ser mantido, essa pessoa define uma nova senha. A página que lista os formatos compatíveis está na [documentação de migração](https://docs.didit.me/authentication/migration).

## Limites do arquivo

Uma importação é um arquivo CSV ou JSON, de até 25 MB e 100.000 pessoas. As pessoas são importadas em lotes de 1.000, e uma importação interrompida continua de onde parou.

O arquivo enviado é guardado criptografado. Ele é apagado quando a importação termina, quando a simulação dele falha, ou 24 horas depois de uma simulação que nunca foi importada.

## Importe os seus usuários

1. **Abra Importar usuários**

   Na sua aplicação em Produção, abra **Autenticação** e escolha **Importar usuários**. Você precisa de uma função que possa alterar as configurações da Autenticação.

2. **Clique em Nova importação**

   Diga onde os seus usuários estão hoje: outra plataforma de identidade, o seu próprio banco de dados ou uma exportação em CSV ou JSON. Envie o arquivo.

3. **Escolha o que manter**

   Defina as chaves descritas acima para senhas, vínculos sociais, e-mails verificados, apps autenticadores e os seus IDs de usuário.

4. **Rode uma Simulação**

   Todo envio começa com uma simulação. Ela confere cada pessoa e não grava nada, depois mostra quantas pessoas mantêm a senha, quantas precisam redefinir e quantas são ignoradas. Se ela falhar, lista os erros: corrija o arquivo e envie de novo.

5. **Clique em Iniciar importação**

   Confirme para criar as pessoas. O **Histórico de importações** lista cada importação. Rodar uma importação de novo ignora as pessoas que já estão lá.

> **Note:** Contas existentes que as pessoas já criaram por conta própria no seu app com a Didit nunca são alteradas por uma importação.

## Nada muda até você trocar

A importação apenas cria pessoas na Didit. Os seus usuários não percebem nada até o seu app começar a fazer o login deles com a Didit. Até lá, a sua plataforma atual continua funcionando.

## Fazendo a troca

1. Importe os seus usuários.
2. Teste com algumas contas, incluindo uma com senha e uma com login social.
3. Aponte o login do seu app para a Didit. Veja [como adicionar login ao seu app](https://help.didit.me/pt-BR/authentication/add-sign-in-to-your-app).
4. Mantenha os seus IDs de usuário, para que o seu banco de dados não mude.

Se você preferir que um agente de programação com IA escreva o arquivo de exportação, a página também oferece **Migre com seu agente de programação com IA**.

## Relacionados

- [Adicione login ao seu app](https://help.didit.me/pt-BR/authentication/add-sign-in-to-your-app)
- [Veja os logins e gerencie usuários](https://help.didit.me/pt-BR/authentication/users-sessions-and-organizations)
- [Migre usuários na documentação](https://docs.didit.me/authentication/migration)
- [Visão geral da Autenticação na documentação](https://docs.didit.me/authentication/overview)