doc/admin/change-account-owner.html.textile.liquid

   1 ---
   2 layout: default
   3 navsection: userguide
   4 title: "Changing account ownership"
   5 ...
   6 {% comment %}
   7 Copyright (C) The Arvados Authors. All rights reserved.
   8
   9 SPDX-License-Identifier: CC-BY-SA-3.0
  10 {% endcomment %}
  11
  12 It is sometimes necessary to reassign an existing Arvados user account to a new Google account.
  13
  14 Examples:
  15 * A user’s email address has changed from <code>person@old.example.com</code> to <code>person@new.example.com</code>.
  16 * A user who used to authenticate via LDAP is switching to Google login.
  17
  18 This can be done by an administrator using Arvados APIs.
  19
  20 First, determine the user’s existing UUID, e.g., @aaaaa-tpzed-abcdefghijklmno@.
  21
  22 Ensure the new email address is not already associated with a different Arvados account. If it is, disassociate it by clearing that account’s @identity_url@ and @email@ fields.
  23
  24 Clear the @identity_url@ field of the existing user record.
  25
  26 Create a Link object with the following attributes (where @tail_uuid@ is the new email address, and @head_uuid@ is the existing user UUID):
  27
  28 <notextile>
  29 <pre><code>{
  30   "link_class":"permission",
  31   "name":"can_login",
  32   "tail_uuid":"<span class="userinput">person@new.example.com</span>",
  33   "head_uuid":"<span class="userinput">aaaaa-tpzed-abcdefghijklmno</span>",
  34   "properties":{
  35     "identity_url_prefix":"https://www.google.com/"
  36   }
  37 }
  38 </code></pre>
  39 </notextile>
  40
  41 Have the user log in using their <code>person@new.example.com</code> Google account. You can verify this by checking that the @identity_url@ field has been populated.