Teleport

Use the Teleport integration to securely authenticate and access your SSH servers for automation.

Overview

Teleport is a Certificate Authority and an Access Plane for your infrastructure. With Teleport you can:

• Set up Single Sign-On and have one place to access your SSH servers, Kubernetes, Databases, and Web Apps.

With this integration you could access your SSH servers remotely by authenticating first into Teleport and then running SSH command with workflow automation.

Configure Teleport in Fylamynt

• Navigate to Settings > Integrations > Teleport

• Configure a new integration instance

Details needed to set up Teleport in Fylamynt:

Parameter	Description	Required
Proxy Hostname	Hostname proxy to access the Teleport server from outside	True
User Certificate	User certificate to grant access to Teleport server with role-based access control	True

Follow the steps listed below in your Teleport Account to complete the configuration in Fylamynt:

• As you can see in the Fylamynt configuration panel, you need to enter Proxy Hostname, User Certificate and Username for Teleport authentication.

• Enter the 'Proxy Hostname' and 'Username' that was created while setting up the Teleport server.

To generate user certificate please look at the following details:

1. Create a file called 'fylamyntbot.yaml' on your local machine and copy & paste this into it:

    kind: role
    version: v3
    metadata:
      name: fylamyntbot
    spec:
      # SSH options used for user sessions 
      options:
        # max_session_ttl defines the TTL (time to live) of SSH certificates 
        # issued to the users with this role.
        max_session_ttl: 1200h
   
      # allow section declares a list of resource/verb combinations that are
      # allowed for the users of this role. by default nothing is allowed.
      allow:
        logins:
          - root
          - ubuntu
          - ec2-user
        node_labels:
          '*': '*'
    ---
    kind: user
    version: v2
    metadata:
      name: fylamyntbot
    spec:
      roles: ['fylamyntbot']

   • Download and edit fylamyntbot.yaml to your local machine.

   • You likely want to change the 'login' and 'allow' sections of the role to match your environment.

   • You can also change the name to whatever you want.

   • If you want to use an existing Teleport user, skip to step 4.

   • See the Teleport Resources Reference for more detailed information.

2. Upload your fylamntbot.yaml to your Teleport proxy/auth server:

    $ tsh scp --login=root fylamyntbot.yaml [email protected]:/home/youruser/resources                                                             
    fylamyntbot.yaml (584)

3. Create a new role & user (on your Teleport auth host):

    $ tctl create -f fylamyntbot.yaml
    role 'fylamyntbot' has been created
    user "fylamyntbot" has been created

4. Generate a new .pem certificate file for the fylamyntbot user. (on your Teleport auth host):

    $ tctl --auth-server=ec2-52-26-37-93.us-west-2.compute.amazonaws.com:3025 auth sign --user=fylamyntbot --format=file --out=fylamyntbot.pem --overwrite --ttl=1000h
   
    The credentials have been written to fylamyntbot.pem

5. Download the pem file lo your local machine:

    $ tsh scp --login=youruser [email protected]:/home/youruser/resources/fylamyntbot.pem .   
    fylamyntbot.pem (7142)

6. Open the pem file in an editor, select all, and copy the text.

7. Paste the text into the "User Certificate" field in the Fylamynt integration panel.

8. Click "Authorize" to complete the setup.