Comment on page

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.

Integrations - Previous

Sumo Logic

Next - Integrations

Terraform Cloud

Last modified 2yr ago

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