SVI/netbird
1
0
Fork 0
mirror of https://github.com/netbirdio/netbird.git synced 2026-07-27 16:32:34 -04:00
Code Issues 3.0k Packages Projects Releases 10 Wiki Activity

Issue with Group Sync from Okta in Netbird #863

New Issue
Closed
opened 2025-11-20 05:18:51 -05:00 by saavagebueno · 4 comments
saavagebueno commented 2025-11-20 05:18:51 -05:00
Owner
Copy Link

Originally created by @alex-Qk on GitHub (May 9, 2024).

Describe the problem

We are currently setting up group synchronization with Okta in Netbird and have followed the provided manual for Okta integration. However, the documentation lacks specifics on how to properly configure group synchronization (using JWT?). Additionally, there is uncertainty around the use of the Okta API token set up during the integration—specifically, whether it should automatically pull group information.

Any help on how to set up group syncing will be much appreciated.

To Reproduce

Steps to reproduce the behavior:
https://docs.netbird.io/selfhosted/identity-providers#okta

Expected behavior

Groups sync from Okta

Are you using NetBird Cloud?

self-hosted

Originally created by @alex-Qk on GitHub (May 9, 2024). **Describe the problem** We are currently setting up group synchronization with Okta in Netbird and have followed the provided manual for Okta integration. However, the documentation lacks specifics on how to properly configure group synchronization (using JWT?). Additionally, there is uncertainty around the use of the Okta API token set up during the integration—specifically, whether it should automatically pull group information. Any help on how to set up group syncing will be much appreciated. **To Reproduce** Steps to reproduce the behavior: https://docs.netbird.io/selfhosted/identity-providers#okta **Expected behavior** Groups sync from Okta **Are you using NetBird Cloud?** self-hosted
saavagebueno added the self-hostingoktajwt labels 2025-11-20 05:18:51 -05:00
saavagebueno commented 2025-11-20 05:18:52 -05:00
Author
Owner
Copy Link

@mlsmaycon commented on GitHub (May 9, 2024):

Hello @calibratedcat you can ask the folks in NetBird's Slack self-hosted channel, maybe someone from the community already configured Okta with JWT group sync.

@mlsmaycon commented on GitHub (May 9, 2024): Hello @calibratedcat you can ask the folks in NetBird's [Slack self-hosted](https://join.slack.com/t/netbirdio/shared_invite/zt-vrahf41g-ik1v7fV8du6t0RwxSrJ96A) channel, maybe someone from the community already configured Okta with JWT group sync.
saavagebueno commented 2025-11-20 05:18:52 -05:00
Author
Owner
Copy Link

@alex-Qk commented on GitHub (May 9, 2024):

Key to solve this problem was adding groups to these vars:
NETBIRD_AUTH_SUPPORTED_SCOPES="openid profile email groups"
NETBIRD_AUTH_DEVICE_AUTH_SCOPE="openid email groups"

@alex-Qk commented on GitHub (May 9, 2024): Key to solve this problem was adding `groups` to these vars: `NETBIRD_AUTH_SUPPORTED_SCOPES="openid profile email groups"` `NETBIRD_AUTH_DEVICE_AUTH_SCOPE="openid email groups"`
saavagebueno commented 2025-11-20 05:18:52 -05:00
Author
Owner
Copy Link

@mlsmaycon commented on GitHub (May 9, 2024):

Awesome @calibratedcat , did you have to configure anything on the Okta side too?

@mlsmaycon commented on GitHub (May 9, 2024): Awesome @calibratedcat , did you have to configure anything on the Okta side too?
saavagebueno commented 2025-11-20 05:18:52 -05:00
Author
Owner
Copy Link

@alex-Qk commented on GitHub (May 10, 2024):

In Okta, you need to configure the OpenID Connect ID Token section. You need to define Group Claim Filter. In my case, I chose any group by using .* expression. groups is a claim name that will be used in your token. Should match in env listed above.
image

@alex-Qk commented on GitHub (May 10, 2024): In Okta, you need to configure the OpenID Connect ID Token section. You need to define `Group Claim Filter`. In my case, I chose any group by using `.*` expression. `groups` is a claim name that will be used in your token. Should match in env listed above. <img width="755" alt="image" src="https://github.com/netbirdio/netbird/assets/50356247/05b603b4-3765-49d9-acf2-db521ae91669">
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
2021 Q4
2022 Q1
2022 Q1
accessibility
acl
agent
agent
Android
Android
api
authentik
automation
azure
battery-usage
bug
cache
client
client-ui
cloud
cloud-only
cloudflare
community
compatibility
config-idp
config-issue
connection
contribution
coturn
cross-vpn
dashboard
data-usage
distribution
dns
docker
documentation
duplicate
enhancement
enhancement
event-stream
feature-request
freebsd
getting-started
go
good first issue
gui
help wanted
home-assistant
idp
inconsistency
integration
integrations
ios
ipv6
jwt
k8s
keycloak
linux
login
macos
management-service
missing-docs
mobile
moved-internal
needs-review
netbird-ui
networking
new-platform
nginx
notification
okta
openwrt
packaging
peer-management
peer-management
peer-management
performance
postgres
posture-checks
psk
pull-request
Mirrored from GitHub Pull Request
 question
refactor
relay
release
rfc
routes
security
security-related
self-hosting
server
signal
sleep-issue
ssh
ssl
status
store
synology
system-compatibility-issue
test-suite
third-party-integration
triage
triage-needed
troubleshooting
UX
waiting-feedback
windows
wontfix
zitadel
No Label jwt okta self-hosting
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
saavagebueno
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: SVI/netbird#863
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?