Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
28 changes: 27 additions & 1 deletion docs/pages/access-controls/access-request-plugins/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,33 @@ layout: tocless-doc

Teleport Just-in-Time Access Requests allow users to receive temporary elevated
privileges by seeking consent from one or more reviewers, depending on your
configuration.
configuration.

With Teleport's Access Request plugins, users can manage Access Requests from
within your organization's existing messaging and project management solutions.

## Plugin guides

(!docs/pages/includes/access-request-integrations.mdx!)

## Architecture

Access Request plugins are self-contained programs that connect to the Teleport
Auth Service's gRPC API to listen for audit events relating to new or updated
Access Requests. After processing an Access Request event, Access Request plugins
interact with a third-party API (e.g., the Slack or PagerDuty APIs).

Access Request plugins can run within private networks that are isolated from
the Teleport Auth Service. To access the Auth Service API, they connect to the
Proxy Service, which establishes a reverse tunnel for the plugin to access the
Auth Service.
Comment thread
alexfornuto marked this conversation as resolved.

You can run multiple instances of an Access Request plugin for high availability
by deploying each instance in a separate availability zone. There is no need for
additional configuration or load balancing, as plugins avoid creating duplicate
requests to their third-party APIs.

To read more about the architecture of an Access Request plugin, and start
writing your own, read our [Access Request plugin development
guide](../../api/access-plugin.mdx).

Original file line number Diff line number Diff line change
Expand Up @@ -571,6 +571,10 @@ the requested node, the hostname will be displayed in the Review Request page of
the Teleport Web UI.

### Integrating with an external tool

With Teleport's Access Request plugins, users can manage Access Requests from
within your organization's existing messaging and project management solutions.

(!docs/pages/includes/access-request-integrations.mdx!)

### Using TTLs with Access Requests
Expand Down
4 changes: 4 additions & 0 deletions docs/pages/access-controls/access-requests/role-requests.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -154,6 +154,10 @@ to the original set of roles.
## Next Steps

### Integrating with an external tool

With Teleport's Access Request plugins, users can manage Access Requests from
within your organization's existing messaging and project management solutions.

(!docs/pages/includes/access-request-integrations.mdx!)

### Advanced RBAC
Expand Down
4 changes: 0 additions & 4 deletions docs/pages/includes/access-request-integrations.mdx
Original file line number Diff line number Diff line change
@@ -1,7 +1,3 @@
With Teleport's Access Request plugins, users can request,
approve, and deny access without leaving your organization's existing messaging
and project management solutions.

| Integration | Type | Setup Instructions |
| - | - | - |
| Slack | Messaging | [Set up Slack](../access-controls/access-request-plugins/ssh-approval-slack.mdx) |
Expand Down