diaspora_federation/docs/_entities/account_migration.md
cmrd Senya 7e2321d6c9 Introduce alternative form of the account migration message
In the alternative form author can be the new diaspora user
2017-12-27 18:37:49 +02:00

2.9 KiB

title
AccountMigration

This entity is sent when a person changes their diaspora* ID (e.g. when a user migration from one to another pod happens).

Properties

Property Type Description
author [diaspora* ID][diaspora-id] The diaspora* ID of the sender of the entity. The entity may be sent by either old user identity or new user identity.
person [Profile][profile] New profile of a person.
signature [Signature][signature] Signature that validates original and target diaspora* IDs with the private key of the second identity, other than the entity author. So if the author is the old identity then this signature is made with the new identity key, and vice versa.

Optional Properties

Property Type Description
old_identity [diaspora* ID][diaspora-id] The diaspora* ID of the closed account. This field is mandatory if the author of the entity is the new identity.

Signature

The signature base string is produced by concatenating the following substrings together, separated by semicolon (:):

  1. The entity name specifier: AccountMigration.

  2. diaspora* ID of the closed account (old diaspora* ID).

  3. diaspora* ID of the replacement account (new diaspora* ID).

Example of a string:

AccountMigration:old-diaspora-id@example.org:new-diaspora-id@example.com

Example

<account_migration>
  <author>alice@example.org</author>
  <profile>
    <author>alice@newpod.example.net</author>
    <first_name>my name</first_name>
    <last_name/>
    <image_url>/assets/user/default.png</image_url>
    <image_url_medium>/assets/user/default.png</image_url_medium>
    <image_url_small>/assets/user/default.png</image_url_small>
    <birthday>1988-07-15</birthday>
    <gender>Female</gender>
    <bio>some text about me</bio>
    <location>github</location>
    <searchable>true</searchable>
    <nsfw>false</nsfw>
    <tag_string>#i #love #tags</tag_string>
  </profile>
  <signature>
    07b1OIY6sTUQwV5pbpgFK0uz6W4cu+oQnlg410Q4uISUOdNOlBdYqhZJm62VFhgvzt4TZXfiJgoupFkRjP0BsaVaZuP2zKMNvO3ngWOeJRf2oRK4Ub5cEA/g7yijkRc+7y8r1iLJ31MFb1czyeCsLxw9Ol8SvAJddogGiLHDhjE=
  </signature>
  <old_identity>alice@example.org</old_identity>
</account_migration>

[diaspora-id]: {{ site.baseurl }}/federation/types.html#diaspora-id [profile]: {{ site.baseurl }}/entities/profile.html [signature]: {{ site.baseurl }}/federation/types.html#signature