Skip to content

Adding Credentials

Login credentials allow users to log in and verify their identities to online accounts. User credentials are typically a username and password combination used for logging in to online accounts. However, username and password credentials can be combined with more secure authentication tools and biometric elements, known as Multi-factor authentication (MFA), to confirm user identities with a greater degree of certainty.

For information on the features in Megaport ONE that use these credentials, see Compute and Networking.

Note

Credentials in Megaport ONE are encrypted and stored.

You can set credentials for:

  • Cloud
  • Docker
  • SSH

Cloud credentials

You can easily integrate the relevant aspects of your Cloud Service Provider (CSP) accounts with Megaport ONE. You can run a script which will link your CSP credentials and display them in the Cloud Credentials page. After the CSP account is linked to Megaport ONE, you can deploy and monitor resources from within the Megaport ONE Portal.

Note

  • Each CSP has different credential requirements. For details on the values that need to be entered, see the relevant CSP documentation.

  • Currently Amazon Web Services, Google Cloud, and Microsoft Azure are supported. For Microsoft Azure, you need to access your Azure account and copy the subscription ID that you want to use with Megaport ONE before proceeding with the instructions below.

To add cloud credentials

  1. Log in to the Megaport ONE Portal.
  2. Choose Tenant > Settings.
    Tenant Settings option
  3. Select Cloud Credentials.
    The Cloud Credentials page appears. The Status column indicates whether or not cloud credentials have been added for the supported CSPs.
    Cloud Credentials
  4. Click Add Credential.
    The Add Credentials screen appears. Add Credentials
  5. In the Select a cloud drop-down list, select the CSP for which you want to add access credentials.
    These options are available:

    • Amazon Web Services
    • Google Cloud
    • Microsoft Azure

    The Add Credentials screen updates to include more fields, and is different for each supported CSP. The image below shows the screen that is displayed when Amazon Web Services is selected in the Select a cloud drop-down list.

    Add Credentials

  6. In the Enter a description for this cloud credential field, enter a name for the cloud credentials.
    This is a user-defined name that is displayed in Megaport ONE for the credentials.

  7. Complete these steps for the relevant CSP as per the embedded instructions in the screen:

    CSP Credentials Procedure
    Amazon Web Services
    1. In the Permissions drop-down list, select the Megaport ONE features that the permissions are for. These options are available:
      • Network and Compute (Recommended)
      • Compute Only
      • Network Only
    2. Click Copy to clipboard to copy the displayed command to the clipboard. The command will run the onboarding script which will automatically link elements of your AWS account to the Megaport ONE platform.
    3. Click Launch AWS Cloud Shell to run the command in your AWS cloud shell. After this has been successfully completed, your AWS credentials will appear automatically in Megaport ONE and you can deploy and monitor resources in Megaport ONE.
    Google Cloud
    1. In the Project ID field, enter the Google Project ID to use to create and delete resources.
    2. Click Copy to clipboard to copy the displayed command to the clipboard. The command will run the onboarding script which will automatically link elements of your Google Cloud account to the Megaport ONE platform.
    3. Click Launch Google Cloud Shell to run the command in your Google cloud shell. After this has been successfully completed, your Google Cloud credentials will appear automatically in Megaport ONE and you can deploy and monitor resources in Megaport ONE.
    Microsoft Azure
    1. In the Subscription ID field, enter the Azure Subscription ID to use to create and delete resources. If this field is left blank, your default Subscription ID will be used.
    2. Click Copy to clipboard to copy the displayed command to the clipboard. The command will run the onboarding script which will automatically link elements of your Azure account to the Megaport ONE platform.
    3. Click Launch Azure Cloud Shell to run the command in your Azure cloud shell. After this has been successfully completed, your Microsoft Azure credentials will appear automatically in Megaport ONE and you can deploy and monitor resources in Megaport ONE.
  8. Click Close.
    Megaport ONE adds the cloud credentials and is now connected to the CSP account. For the added credentials, the STATUS column changes to ADDED and is displayed in green.
    Credentials Added

To delete cloud credentials

  1. Log in to the Megaport ONE Portal.
  2. Choose Tenant > Settings.
    Tenant Settings option
  3. Select Cloud Credentials.
  4. Click the gear icon (Gear Icon) for the cloud credentials that you want to delete.
  5. Select Uninstall Credential.
    The Delete Credential screen appears (AWS example shown).  Delete Credential Screen
  6. Click Copy to Clipboard to copy the displayed command to the clipboard.
  7. Click Launch CSP Cloud Shell to run the command in your cloud shell to uninstall the selected credentials.
  8. Type DELETE (all caps) to confirm.
  9. Click Delete.
    The cloud credentials are deleted.

Note

After uninstalling credentials in the Megaport ONE Portal, we recommend that you also uninstall the credentials on the CSP side.

Docker credentials

Docker is a set of platform as a service products that use OS-level virtualization to deliver software in packages called containers. The service has both free and premium tiers. The software that hosts the containers is called Docker Engine.

Docker allocates a read-write file system to the container, as its final layer. This allows a running container to create or modify files and directories in its local file system. Docker creates a network interface to connect the container to the default network. For more information, see https://docs.docker.com/.

In Megaport ONE, the Docker credentials allow you to add a Docker container to a KubernetesAn open-source system for automating deployment, scaling, and management of containerized applications. cluster. There aren’t any Kubernetes credentials, you share a public repository URL and that provides access. For more information, see Creating a Cluster.

Docker registry

The registry is a stateless, highly scalable server side application that stores and allows you to distribute Docker images. The registry is open-source, under the permissive Apache license.

You should use the registry if you want to:

  • tightly control where your images are being stored
  • fully own your images distribution pipeline
  • integrate image storage and distribution tightly into your in-house development workflow

To add Docker credentials

  1. Log in to the Megaport ONE Portal.
  2. Choose Tenant > Settings.
    Tenant Settings option
  3. Select Docker Credentials.
    The Docker Credentials page appears. Any Docker credentials that have been set up are displayed. Docker Credentials
  4. Click Add Credential.
    The Add Docker Credential screen appears.
    Add Docker Credentials
  5. Specify the Docker credential details:
    • Credential Name – The name of the Docker credentials to display in Megaport ONE.
    • Registry URL – The Docker registry URL.
      For example, https://myregistry.docker.com
    • Registry Username – The Docker registry username.
    • Registry Password/Token – The Docker registry password or token.
  6. Click Confirm.
    The Docker credentials are added.

To delete Docker credentials

  1. Log in to the Megaport ONE Portal.
  2. Choose Tenant > Settings.
    Tenant Settings option
  3. Select Docker Credentials.
  4. Click the gear icon (Gear Icon) for the Docker credentials that you want to delete.
  5. Select Delete Credential.
    The Confirm Deletion screen appears. Confirm Delete Docker Credentials Screen
  6. Type DELETE (all caps) to confirm.
  7. Click Delete.
    The Docker credentials are deleted.

SSH credentials

The Secure Shell (SSH) protocol is a cryptographic network protocol for operating network services securely over an unsecured network. This allows computers to securely communicate and share data. The most notable applications of SSH are remote login and command-line execution. SSH applications are based on a client–server architecture, connecting an SSH client instance with an SSH server.

An SSH key relies on the use of two related keys, a public key and a private key. Together they create a key pair which is used as the secure access credential. The private key is secret, known only to the user, and is encrypted and stored safely.

In Megaport ONE, SSH credentials (keys) are specific to an Equinix Metal project. This is a public project key added to your Equinix Metal account. This key is specific to your single project. This provisions the machine, and SSH allows you to access the machine and install everything that is required.

To add SSH credentials

  1. Log in to the Megaport ONE Portal.
  2. Choose Tenant > Settings.
    Tenant Settings option
  3. Select SSH Credentials.
    The SSH Credentials page appears. Any SSH credentials that have been set up are displayed.
    SSH Credentials
  4. Click Add Credential.
    The Add New SSH Key screen appears.
    Add SSH Credentials
  5. Specify the SSH key details:

  6. Click Confirm.
    The SSH credentials are added.

To delete SSH credentials

  1. Log in to the Megaport ONE Portal.
  2. Choose Tenant > Settings.
    Tenant Settings option
  3. Select SSH Credentials.
  4. Click the gear icon (Gear Icon) for the SSH credentials that you want to delete.
  5. Select Delete Credential.
    The Confirm Deletion screen appears. Confirm Delete SSH Credentials Screen
  6. Type DELETE (all caps) to confirm.
  7. Click Delete.
    The SSH credentials are deleted.

Last update: 2022-12-15