-
Notifications
You must be signed in to change notification settings - Fork 1.8k
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Improve access graph documentation #49314
Merged
Merged
Changes from 1 commit
Commits
File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -152,6 +152,30 @@ Insecure paths are also visible in a user's access paths. To view them, click on | |
from the context menu. This will show the Teleport permissions granted to the user, the resources they can access, | ||
and any detected insecure paths. | ||
|
||
**Access Graph: Dedicated `ssh_keys` SQL View** | ||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. If this is a section heading, I would use header syntax ( |
||
|
||
Starting in version **v1.25.0**, Access Graph introduces a dedicated `ssh_keys` SQL view for managing SSH access paths. | ||
This view excludes access paths granted through Teleport and focuses on: | ||
- Displaying identified access paths between identities and SSH nodes. | ||
- Listing existing SSH Authorized Keys configured for nodes, even if `tsh scan keys` fails to detect matching SSH private keys. | ||
tigrato marked this conversation as resolved.
Show resolved
Hide resolved
|
||
|
||
Below are a few example queries demonstrating how the `ssh_keys` view can be useful for identifying potential backdoors. | ||
|
||
- List all SSH access paths for Teleport SSH nodes and users: | ||
```sql | ||
SELECT * FROM ssh_keys; | ||
``` | ||
|
||
- View insecure access paths and SSH Authorized Keys for a specific node: | ||
```sql | ||
SELECT * FROM ssh_keys WHERE resource='<Var name="resource name" />'; | ||
``` | ||
|
||
- View insecure access paths and SSH Authorized Keys for a subset of nodes using labels: | ||
```sql | ||
SELECT * FROM ssh_keys WHERE resource_labels @> '{"env": "dev"}'; | ||
``` | ||
|
||
|
||
## Jamf Pro Integration | ||
|
||
|
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
What does "spam" mean in this case? To me, this sounds a little judgmental towards a Teleport feature, which seems out of place in documentation.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Spam refers to an excessive number of entries. When a user with access to all resources logs in using a standard connector, it generates N access path changes, where N is the number of resources they have access to.