Skip to content

Commit

Permalink
Clone 3.2 docs for 4.0
Browse files Browse the repository at this point in the history
  • Loading branch information
benarent committed May 29, 2019
1 parent 3094641 commit 584ab03
Show file tree
Hide file tree
Showing 65 changed files with 7,699 additions and 0 deletions.
42 changes: 42 additions & 0 deletions docs/4.0.yaml
Original file line number Diff line number Diff line change
@@ -0,0 +1,42 @@
site_name: Gravitational Teleport
site_url: https://gravitational.com/teleport/docs
repo_url: https://github.com/gravitational/teleport
site_description: SSH and Kubernetes Gateway for Clusters and Teams
site_author: Gravitational Inc
copyright: Gravitational Inc, 2016-19

# output directory:
site_dir: ../build/docs/4.0
docs_dir: "4.0"

theme: readthedocs
theme_dir: theme
markdown_extensions:
- markdown_include.include
- admonition
- def_list
- footnotes
extra_css: []
extra_javascript: []
extra:
version: 4.0
pages:
- Documentation:
- Introduction: intro.md
- Quick Start Guide: quickstart.md
- Architecture: architecture.md
- User Manual: user-manual.md
- Admin Manual: admin-guide.md
- FAQ: faq.md
- Teleport Enterprise:
- Introduction: enterprise.md
- Quick Start Guide: quickstart-enterprise.md
- RBAC: ssh_rbac.md
- Single sign-on (SSO): ssh_sso.md
- Guides:
- Okta: ssh_okta.md
- Active Directory (ADFS): ssh_adfs.md
- One Login: ssh_one_login.md
- OIDC: oidc.md
- Trusted Clusters: trustedclusters.md
- Kubernetes Guide: kubernetes_ssh.md
41 changes: 41 additions & 0 deletions docs/4.0/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,41 @@
# Overview

## Introduction

Gravitational Teleport ("Teleport") is a tool for remotely accessing isolated clusters of
Linux servers via SSH or HTTPS. Unlike traditional key-based access, Teleport
enables teams to easily adopt the following practices:

- Avoid key distribution and [trust on first use](https://en.wikipedia.org/wiki/Trust_on_first_use) issues by using auto-expiring keys signed by a cluster certificate authority (CA).
- Enforce 2nd factor authentication.
- Connect to clusters located behind firewalls without direct Internet access via SSH bastions.
- Record and replay SSH sessions for knowledge sharing and auditing purposes.
- Collaboratively troubleshoot issues through session sharing.
- Discover online servers and Docker containers within a cluster with dynamic node labels.

Teleport is built on top of the high-quality [Golang SSH](https://godoc.org/golang.org/x/crypto/ssh)
implementation and it is fully compatible with OpenSSH.

## Why Build Teleport?

Mature tech companies with significant infrastructure footprints tend to implement most
of these patterns internally. Teleport allows smaller companies without
significant in-house SSH expertise to easily adopt them, as well. Teleport comes with an
accessible Web UI and a very permissive [Apache 2.0](https://github.com/gravitational/teleport/blob/master/LICENSE)
license to facilitate adoption and use.

Being a complete standalone tool, Teleport can be used as a software library enabling
trust management in complex multi-cluster, multi-region scenarios across many teams
within multiple organizations.

## Who Built Teleport?

Teleport was created by [Gravitational Inc](https://gravitational.com). We have built Teleport
by borrowing from our previous experiences at Rackspace. It has been extracted from [Telekube](https://gravitational.com/telekube/), our system for helping our clients to deploy
and remotely manage their SaaS applications on many cloud regions or even on-premise.

## Resources
To get started with Teleport we recommend starting with the [Architecture Document](architecture.md). Then if you want to jump right in and play with Teleport, you can read the [Quick Start](quickstart.md). For a deeper understanding of how everything works and recommended production setup, please review the [Admin Manual](admin-guide.md) to setup Teleport and the [User Manual](user-manual.md) for daily usage. There is also an [FAQ](faq.md) where we'll be collecting common questions. Finally, you can always type `tsh`, `tctl` or `teleport` in terminal after Teleport has been installed to review those reference guides.

The best way to ask questions or file issues regarding Teleport is by creating a Github issue or pull request. Otherwise, you can reach us through the contact form or chat on our [website](https://gravitational.com/).

Loading

0 comments on commit 584ab03

Please sign in to comment.