This mono-repository contains the source code for the web UIs of the following projects: Teleport
The code is organized in terms of independent yarn packages which reside in the packages directory.
You can make production builds locally or you can use Docker to do that.
Make sure that you have yarn installed on your system since this monorepo uses the yarn package manager.
Then you need download and initialize these repository dependencies.
$ yarn install
To build the Teleport open source version
$ yarn build-teleport-oss
The resulting output will be in the /packages/{package-name}/dist/
folders respectively.
To build the Teleport community version
$ make build-teleport-oss
To avoid having to install a dedicated Teleport cluster, you can use a local development server which can proxy network requests to an existing cluster.
For example, if https://example.com:3080/web
is the URL of your cluster then:
To start your local Teleport development server
$ yarn start-teleport --target=https://example.com:3080/web
This service will serve your local javascript files and proxy network requests to the given target.
Keep in mind that you have to use a local user because social logins (google/github) are not supported by development server.
We use jest as our testing framework.
To run all jest unit-tests:
$ yarn run test
To run jest in watch-mode
$ yarn run tdd
We use storybook for our interactive testing. It allows us to browse our component library, view the different states of each component, and interactively develop and test components.
To start a storybook:
$ yarn run storybook
This command will open a new browser window with storybook in it. There you will see components from all packages so it makes it faster to work and iterate on shared functionality.
- Install plugin: https://github.com/prettier/prettier-vscode
- Go to Command Palette: CMD/CTRL SHIFT P (or F1)
- Type
open settings
- Select
Open Settings (JSON)
- Include the below snippet and save:
// Set the default
"editor.formatOnSave": false,
// absolute config path
"prettier.configPath": ".prettierrc",
// enable per-language
"[html]": {
"editor.formatOnSave": true,
"editor.defaultFormatter": "esbenp.prettier-vscode"
},
"[javascript]": {
"editor.formatOnSave": true,
"editor.defaultFormatter": "esbenp.prettier-vscode"
},
"[javascriptreact]": {
"editor.formatOnSave": true,
"editor.defaultFormatter": "esbenp.prettier-vscode",
},
"[typescript]": {
"editor.formatOnSave": true,
"editor.defaultFormatter": "esbenp.prettier-vscode"
},
"[typescriptreact]": {
"editor.formatOnSave": true,
"editor.defaultFormatter": "esbenp.prettier-vscode",
},
"[json]": {
"editor.formatOnSave": true,
"editor.defaultFormatter": "vscode.json-language-features"
},
"[jsonc]": {
"editor.formatOnSave": true,
"editor.defaultFormatter": "vscode.json-language-features"
},
"[markdown]": {
"editor.formatOnSave": true,
"editor.defaultFormatter": "esbenp.prettier-vscode",
},
"editor.tabSize": 2,
When developing MFA sections of the codebase, you may need to configure the teleport.yaml
of your target teleport cluster to accept hardware keys registered over the local development setup. Webauthn can get tempermental if you try to use localhost as your rp_id
, but you can get around this by using https://nip.io/. For example, if you want to configure optional webauthn
mfa, you can set up your auth service like so:
auth_service:
authentication:
type: local
second_factor: optional
webauthn:
rp_id: proxy.0.0.0.0.nip.io
Then start the dev server like yarn start-teleport --target=https://proxy.0.0.0.0.nip.io:3080
and access it at https://proxy.0.0.0.0.nip.io:8080.
Though u2f
tends to be more forgiving about using localhost, its still sometimes useful to configure it with nip.io in order that your registered u2f keys are compatible with webauthn. For example, if you wished to configure a u2f version of the webauthn setup above, you could use an auth_service
like this:
auth_service:
authentication:
type: local
second_factor: optional
webauthn:
disabled: true
u2f:
app_id: https://proxy.0.0.0.0.nip.io
facets:
- https://proxy.0.0.0.0.nip.io
- https://proxy.0.0.0.0.nip.io:8080
After registering a key, you could switch your server to use webauthn
by changing the configuration to
auth_service:
authentication:
type: local
second_factor: optional
webauthn:
rp_id: proxy.0.0.0.0.nip.io
u2f:
app_id: https://proxy.0.0.0.0.nip.io
facets:
- https://proxy.0.0.0.0.nip.io
- https://proxy.0.0.0.0.nip.io:8080
and your previously registered u2f key would be able to remain in use.