User Accounts¶
When you sign up or accept a collaborator invitation for Equinix Metal™, you create a user account. Your user account manages:
- Your profile and log-in information.
- Your security settings.
- SSH Keys tied to your user.
- API Keys tied to your user.
Your Profile¶
Your user profile consists of your name, email, and phone number. Your email is used for sign-on and communication preferences. You may have more than one email tied to your user account. Your phone number is optional, but can be used for things like multi-factor authentication.
To access your user Profile in the Equinix Metal console, click on your user icon, and click My Profile.
You can access and update your profile on the Overview tab.
You can retrieve your user information from the CLI with the metal user get
command.
metal user get
You can manage your profile through the API using the /user
endpoint. To view your user profile send a GET
request:
curl -X GET -H 'X-Auth-Token: <API_TOKEN>' https://api.equinix.com/metal/v1/user
To update your user profile, send a PUT
request to the /user
endpoint, with the fields containing the updated information in the request body.
curl -X PUT \
-H "Content-Type: application/json" \
-H "X-Auth-Token: <API_TOKEN>" \
"https://api.equinix.com/metal/v1/user" \
-d '{
"first_name": "string",
"last_name": "string",
"phone_number": "string",
"timezone": "string",
"password": "string"
}'
Changing Your Password¶
You can update change your password on the Security tab of your Profile. Enter your current password in the and the new password and click Save new password.
To change your password through the API, you can send a PUT
request to the /user
endpoint, with the new password in the "password"
field of the request body.
curl -X PUT \
-H "Content-Type: application/json" \
-H "X-Auth-Token: <API_TOKEN>" \
"https://api.equinix.com/metal/v1/user" \
-d '{
"password": "string"
}'
If you have lost your password and need to reset it, please use the Forgot password? link on the sign-in page, or contact support.
Multi-factor Authentication¶
Multi-factor authentication (MFA) allows you to configure an additional means of authentication on your account, reducing the risk of account takeover or other malicious activity. Each time you log into your account, you will have to provide an authorization code from either an authenticator app or an SMS text message. Data rates may apply.
Enabling MFA¶
Multi-factor authentication set up is on the Security tab of your Profile. When 2FA is inactive, you have the option to either Setup with App or Use SMS. Choose which method you would like to use.
App Setup - If you choose to use an app, then the Enable MFA Using an App panel appears. Use your choosen app to scan the QR code, or click Copy secret as text which will copy the secret to the clipboard for you to paste into the app. Once you have entered the secret into the app, it should return an OTP token for you to enter back into Equinix Metal. Click Enable App to complete the process.
Using SMS - If you choose to use SMS, then the Enable MFA Using SMS panel appears. Enter a phone number that can receive SMS messages and click Send Code to send the initial OTP token to the number. Enter the token back into the Equinix Metal console. Click Enable SMS to complete the process.
Disabling MFA¶
To disable two-factor authentication, toggle MFA status, enter the current OTP code in the field, and click Turn Off MFA.
Users and Organizations¶
For billing, entitlement, and collaboration purposes, all Equinix Metal users are part of an organization. If you sign up for Equinix Metal as an individual, you are made the owner of an organization that is tied to your user account. If you sign up for Equinix Metal through an invitation, you are added as a user to the organization that invited you. A user can be a member of many organizations.
Documentation on organizations, user roles, and entitlements, is on the Organizations page.
Account Approval and Abuse¶
When signing up for an Equinix Metal account you may receive a notification informing you that your account has been flagged for manual review. Please note: this is in no way a judgment of your character, and the decision to flag an account is made by an algorithm, not an Equinix employee.
Since we are an on-demand hosting provider, our platform is often the target of payment fraud and other forms of abusive usage. Therefore, it is imperative that we properly vet all Equinix Metal customers for possible fraud and abuse risk factors.
What happens when my account is flagged?¶
When our system flags your account for manual review we automatically open a ticket for you regarding the account review. You can find out what further information is required by contacting support.
At this point you will be unable to interact with our customer portal until your account has been cleared by one of our support engineers.
How do I clear my account?¶
When your account is marked for manual review we will reply to the ticket we opened for you. This may only be to inform you that the review process is complete, and that your account has been approved, but we often request that you provide some additional information to help us with the review.
Note: if you wish to use Equinix Metal for work associated with your company, use your company email on signup.
To help us understand confirm that you intend to operate within Equinix Metal's ToS, please describe your use case in as much detail as you are willing to share. Please be aware that some use cases are not allowed, while others are not supported. If your use case is not supported, we will still approve your account, and do our best to help you adjust your project requirements to fit the Equinix Metal platform, should you choose to do so.