Migrera meddelanden till Gmail som e-postmeddelanden som är krypterade på klientsidan

Om organisationen har meddelanden i en annan tjänst eller i ett annat krypteringsformat kan du som administratör migrera dessa meddelanden till Gmail som meddelanden som är krypterade på klientsidan i S/MIME-format.

Migrerade meddelanden som innehåller en digital signatur och kryptering renderas säkert i Gmail med infogade bilder, hyperlänkar och bilagor synliga.

Vissa tjänster kan tillåta användare att skapa S/MIME-meddelanden utan en digital signatur och har offentligt kända sårbarheter. När dessa meddelanden med enbart kryptering importeras till Gmail visas de i ett säkert format som döljer möjliga sårbarheter. Det innebär att kryptering på klientsidan (CSE) i Gmail inte visar infogade bilder, hyperlänkar eller bilagor i användargränssnittet, även om det underliggande meddelandet behåller allt innehåll.

Migrera S/MIME-krypterade meddelanden

Gmail CSE har inbyggt stöd för standardformatet S/MIME för meddelandekryptering som även används av Microsoft och andra e-posttjänster. Om du migrerar krypterade S/MIME-meddelanden från en Microsoft-tjänst till Gmail kan du migrera krypterade meddelanden utan att ändra dem.

För att Gmail CSE ska kunna dekryptera och visa S/MIME-meddelanden som tidigare fanns i en Microsoft-tjänst måste användarkontona med Gmail konfigureras med samma S/MIME-användarcertifikat som användes i Microsoft-miljön. Du måste även konfigurera Gmail API och Gmail CSE för användarna med samma certifikat som finns i Microsoft-tjänsten. Mer information finns i Enbart Gmail: Konfigurera S/MIME-certifikat för kryptering på klientsidan.

När Gmail-kontona har konfigurerats med S/MIME-certifikaten kan du migrera meddelanden från Microsoft-tjänsten till Gmail. Mer information finns i Migrera din data till Google Workspace.

Migrera format som inte är S/MIME och arkiv med vanlig text

Om organisationen har meddelanden som är krypterade i ett annat format än S/MIME eller har arkiv med vanlig text som du vill kryptera innan du migrerar kan du använda migreringsverktyget för Gmail CSE för att konvertera meddelanden till S/MIME-formatet som används av Gmail CSE.

Så här använder du migreringsverktyget för att överföra meddelanden:

  1. Exportera de krypterade meddelandena från tjänsteleverantören.
  2. Om meddelandena är krypterade dekrypterar du e-postmeddelandena till klartext med hjälp av verktygen från krypteringsleverantören som inte använder S/MIME.
  3. När meddelandena har dekrypterats till klartext använder du Gmail CSE Migration Utility för att kryptera meddelandena lokalt och migrera dem till Gmail CSE.

Om du använder Gmail

Om du vill använda migreringsverktyget för att överföra meddelandena exporterar du de krypterade meddelandena från Gmail med Google Takeout eller Google Workspace Arkiv. Använd verktygen från din krypteringsleverantör som inte använder S/MIME för att dekryptera e-postmeddelandena till klartext.

Gmail CSE Migration Utility körs över meddelanden i klartext. När du exporterar meddelandena via Google Arkiv ska du se till att exporten använder filformatet MBOX. PST-filerna som genereras av Arkiv innehåller inte tillräckligt med information för att meddelanden ska kunna infogas i Gmail igen.

För varje importerat meddelande lägger Gmail CSE Migration Utility till en S/MIME-krypterad kopia av meddelandet utöver det ursprungliga meddelandet. Varje användarkonto med Gmail måste ha tillräckligt med ledigt utrymme för att meddelandekopior ska kunna infogas.

Systemkrav

  • Windows 10/11 x86_64
  • Linux x86_64
  • macOS 12+ x86_64 eller M

Filformat som stöds

Gmail CSE Migration Utility körs över meddelanden i klartext. Se till att meddelandena har något av följande filformat:

  • PST
  • Mbox

Migreringsverktyget för Gmail CSE har för närvarande inte stöd för MSG-filformatet. Mer information om format som stöds finns i dokumentationen om filformat.

Innan du börjar

Innan du kan använda migreringsverktyget för att migrera meddelanden måste du konfigurera Gmail API och Gmail CSE för användarna. Mer information finns i Enbart Gmail: Konfigurera S/MIME-certifikat för kryptering på klientsidan.

Migreringen återanvänder API-uppgifterna för Google-tjänstkontot som du använde under konfigurationen av Gmail CSE.

Ladda ned Gmail CSE Migration Utility

  1. Ladda ned migreringsverktyget för Gmail CSE till enheten.

Extrahera verktyget gmail-cse-migrate från det nedladdade paketet.

Kör Gmail CSE Migration Utility

Om du vill använda migreringsverktyget anger du följande kommando i en terminal eller kommandotolk. Ersätt platshållarna med dina flaggor och filnamn.

Windows

> gmail-cse-migrate.exe [Optional flags] -api-credential=<filename> -input=<filename>

Om du till exempel vill migrera e-postmeddelanden från en fil med namnet input.pst till Gmail CSE anger du följande kommando:

> gmail-cse-migrate.exe -api-credential=my-api-credential.json -input=input.pst

Linux, macOS

$ ./gmail-cse-migrate [Optional flags] -api-credential=<filename> -input=<filename>

Om du till exempel vill migrera e-postmeddelanden från en fil med namnet input.pst till Gmail CSE anger du följande kommando:

$ ./gmail-cse-migrate -api-credential=my-api-credential.json -input=input.pst

Obs!

  • Ange följande obligatoriska flaggor när du kör kommandot:
    -api-credential=<filename> och -input=<filename>
  • Om du vill ha detaljerad information om funktionerna för de obligatoriska flaggorna anger du gmail-migrate.exe -help.
  • Migreringsverktyget kan användas på både enskilda indatafiler och kataloger.
  • För en indatakatalog går migreringsverktyget rekursivt igenom katalogen för att söka efter filer med tilläggen .pst och .mbox.
  • Du kan ange flera indatafiler och kataloger i en enda körning.

Ditt Google-tjänstkonto måste beviljas användning av OAuth-omfattningen https://www.googleapis.com/auth/gmail.modify när migreringen utförs.

Testa migreringen

Vi rekommenderar starkt att du gör en provkörning av migreringsprocessen innan du lägger till meddelanden i Gmail-lagringsutrymmet. Det hjälper dig att identifiera och åtgärda eventuella problem som kan orsaka att migreringen misslyckas. Om du till exempel inte har konfigurerat några CSE-nyckelpar kan det hända att vissa meddelanden inte krypteras under migreringen. En provkörning hjälper dig att identifiera problemet innan det leder till att migreringen misslyckas.

Använd flaggan -dryrun för att utföra en testkörning. Om den privata nyckeln för Google-tjänstkontot till exempel finns i c:my_svc_acct.json2 anger du följande kommando:

gmail-migrate.exe -input user1.pst -input user2.pst -api-credential c:my_svc_acct.json -dryrun

I det här exemplet utförs en testkörning av migreringsprocessen på de två indatafilerna user1.pst och user2.pst. Testkörningen verifierar följande:

  • Meddelandena från filerna kan analyseras.
  • Meddelandena kan krypteras som förberedelse för migrering.

Slutför migreringen

När du har kört testet anger du följande kommando för att slutföra migreringen.

gmail-migrate.exe -input user1.pst -input user2.pst -api-credential c:my_svc_acct.json

Obs! Google-tjänstkontot måste beviljas OAuth-omfattningen https://www.googleapis.com/auth/gmail.readonly när det körs i testläge.

Verifiera migreringen

När en meddelandemigrering har slutförts infogas en S/MIME-krypterad kopia av meddelandet i meddelandeägarens Gmail-konto tillsammans med det ursprungliga meddelandet som är krypterat i ett format som inte är S/MIME. Migreringsverktyget raderar inte det ursprungliga meddelandet.

När granskningen av användarkontot visar att S/MIME-kopiorna kan användas av Gmail CSE kan kontots ägare eller företagsadministratören radera de ursprungliga meddelandena som krypterades i formatet som inte är S/MIME. För att hjälpa dig att hitta dessa meddelanden lägger migreringsverktyget för Gmail CSE till en anpassad användaretikett med namnet Gmail CSE Migration Source Messages i varje ursprungligt meddelande.

Var försiktig när du raderar meddelanden i Gmail-gränssnittet. Standardgränssnittet samlar meddelanden i trådar eller konversationer. Om du raderar ett enskilt meddelande raderas hela konversationen, inklusive okrypterade meddelanden och de infogade CSE-meddelandekopiorna. Användarna ska först inaktivera konversationsvyn via inställningsfönstret i Gmail så att raderingen gäller enskilda meddelanden i stället för trådar.

Om migreringen misslyckas …

  1. Så här identifierar du orsaken till felet:
    • Granska loggfilen efter felmeddelanden.
    • Se till att migreraren har de behörigheter som krävs för att få åtkomst till PST-filerna och Gmail-kontot.
    • Kontrollera att API-uppgifterna är giltiga.
    • Kontrollera att PST-filerna inte är skadade.
  2. Gör nödvändiga ändringar för att åtgärda orsaken till den misslyckade migreringen.
  3. Kör migreringskommandot igen.

Obs! Migreringsverktyget hoppar över meddelanden som har migrerats i det föregående försöket.

Migreringsflaggor

Migrator-flaggor kan anges med ett eller två inledande bindestreck, inte snedstreck. I Windows kan du till exempel ange flaggan för visning av hjälpinformation med något av följande:

-help

--help

För flaggor som accepterar ett strängargument kan du ange dem med ett likhetstecken eller ett blanksteg för att definiera argumentet. Följande flaggor motsvarar till exempel varandra:

-input=filename.pst

-input filename.pst

Hjälpflaggor

Flagga Beskrivning
-version

Skriver ut versionssträngen.

Om du kontaktar supporten ska du ange vilken version du har problem med.

-help Skriver ut en användningsskärm med alla flaggor.
-logfile

Specificerar utdatafilen som körningsloggar skrivs till.

Om den särskilda texten TIMESTAMP finns i filnamnet
ersätts den med körningens starttid.

Migreringsflaggor

Flagga Beskrivning
input <directory_or_file> Obligatoriskt. Anger indatakatalogen eller e-postfilen.
-api-credential <file> Obligatoriskt. Anger en JSON-fil som innehåller den privata nyckeln till ett
Google-tjänstkonto som har delegerats domänomfattande åtkomst.
-dryrun Valfritt. Anges för att verifiera att migreraren kan behandla
e-postmeddelandefilerna och förbereda meddelandena för migrering.