# Como passo os meus utilizadores existentes para a Didit?

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

Importa utilizadores de outra plataforma com palavras-passe, e-mails verificados e ligações sociais, sem novo registo. Faz primeiro uma simulação.

Abre **Autenticação → Importar utilizadores** numa aplicação em Produção, carrega em **Nova importação**, carrega um ficheiro CSV ou JSON, faz uma **Simulação** e depois carrega em **Iniciar importação**. As pessoas mantêm a palavra-passe, o e-mail verificado, as ligações sociais, as aplicações de autenticação e os teus IDs de utilizador, e nada muda para elas até a tua aplicação as fazer iniciar sessão com a Didit.

![A página Importar utilizadores na consola 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 utilizadores: começa uma nova importação e acompanha cada uma no histórico de importações.*

Podes trazer pessoas de outra plataforma de identidade, como o Auth0, o Clerk ou o Firebase, da tua própria base de dados, ou de qualquer exportação CSV ou JSON. A página **Importar utilizadores** aparece apenas nas aplicações em Produção, e abre com o título **Migração**.

## O que uma importação pode manter

| Mantido | Notas |
|---|---|
| Hashes de palavras-passe | Ativa **Importar hashes de palavras-passe**. Caso contrário, escolhe **Precisam de uma nova palavra-passe**. |
| E-mails verificados | **Manter emails verificados**: as pessoas não confirmam o e-mail de novo. |
| Ligações de início de sessão social | **Manter ligações de início de sessão social**: as contas de fornecedores suportados continuam ligadas. |
| Aplicações de autenticação | **Manter aplicações de autenticação**. |
| Os teus IDs de utilizador | **Manter os seus IDs de utilizador**: os IDs que ligam a tua base de dados a estes utilizadores. |
| Funções na organização | As pessoas mantêm a sua função na respetiva organização. |

As chaves de acesso não podem ser importadas. Uma chave de acesso pertence ao domínio onde foi criada, que é o teu domínio antigo, por isso as pessoas adicionam uma nova chave de acesso depois de iniciarem sessão.

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

## Limites do ficheiro

Uma importação é um ficheiro CSV ou JSON, até 25 MB e 100,000 pessoas. As pessoas são importadas em lotes de 1,000, e uma importação interrompida retoma onde parou.

O ficheiro carregado é guardado cifrado. É eliminado quando a importação termina, quando a sua simulação falha, ou 24 horas depois de uma simulação que nunca foi importada.

## Importar os teus utilizadores

1. **Abrir Importar utilizadores**

   Na tua aplicação em Produção, abre **Autenticação** e escolhe **Importar utilizadores**. Precisas de uma função que possa alterar as definições da Autenticação.

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

   Indica onde estão os teus utilizadores hoje: outra plataforma de identidade, a tua própria base de dados ou uma exportação CSV ou JSON. Carrega o ficheiro.

3. **Escolher o que manter**

   Define os interruptores descritos acima para palavras-passe, ligações sociais, e-mails verificados, aplicações de autenticação e os teus IDs de utilizador.

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

   Cada carregamento começa com uma simulação. Verifica cada pessoa e não escreve nada, e depois mostra quantas pessoas mantêm a palavra-passe, quantas precisam de a repor e quantas são ignoradas. Se falhar, lista os erros: corrige o ficheiro e carrega-o de novo.

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

   Confirma para criar as pessoas. O **Histórico de importações** lista todas as importações. Executar uma importação de novo ignora as pessoas que já estão dentro.

> **Note:** As contas existentes que as pessoas já criaram por si próprias na tua aplicação com a Didit nunca são alteradas por uma importação.

## Nada muda até passares

A importação só cria pessoas na Didit. Os teus utilizadores não notam nada até a tua aplicação começar a fazê-los iniciar sessão com a Didit. Até lá, a tua plataforma atual continua a funcionar.

## Passar para a Didit

1. Importa os teus utilizadores.
2. Testa com algumas contas, incluindo uma com palavra-passe e uma com início de sessão social.
3. Aponta o início de sessão da tua aplicação para a Didit. Consulta [adicionar o início de sessão à tua aplicação](https://help.didit.me/pt-PT/authentication/add-sign-in-to-your-app).
4. Mantém os teus IDs de utilizador, para a tua base de dados não mudar.

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

## Relacionado

- [Adicionar o início de sessão à tua aplicação](https://help.didit.me/pt-PT/authentication/add-sign-in-to-your-app)
- [Ver inícios de sessão e gerir utilizadores](https://help.didit.me/pt-PT/authentication/users-sessions-and-organizations)
- [Migrar utilizadores na documentação](https://docs.didit.me/authentication/migration)
- [Visão geral da Autenticação na documentação](https://docs.didit.me/authentication/overview)