-
Notifications
You must be signed in to change notification settings - Fork 49
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
13 changed files
with
161 additions
and
75 deletions.
There are no files selected for viewing
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added
BIN
+129 KB
public/docs-static/img/how-to-guides/auto-offboard-users/activity-monitoring.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added
BIN
+315 KB
...s-static/img/how-to-guides/endpoint-detection-and-response/edr-integrations.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
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 |
---|---|---|
@@ -0,0 +1,50 @@ | ||
# Automatically Offboard Team Members from NetBird | ||
|
||
[NetBird's IdP-Sync integration](https://docs.netbird.io/how-to/idp-sync) simplifies offboarding team members, enhancing | ||
security and efficiency. With this integration, you can automatically revoke access when users leave the company, when | ||
temporary access for a freelancer ends after project completion, or when a seasonal employee's contract concludes. | ||
Likewise, you can use this integration to restrict access to specific resources or environments when a project finishes. | ||
For instance, you can limit network and resource access when a team member is removed from a group or when an entire group | ||
is deleted from your Identity Provider. | ||
|
||
## Removing Team Members | ||
|
||
In this tutorial, we will focus on `user_01`, `user_02`, and `user_03`. From NetBird's `Users` dashboard, you can see | ||
that `user_01` is part of the `IT Administrators` group, while `user_02` and `user_03` belong to the `Staging` group. | ||
|
||
![NetBird Users](/docs-static/img/how-to-guides/auto-offboard-users/GT3eAeU.png) | ||
|
||
To get started, access your Identity Provider (IdP) dashboard. For this example, we’ll use [Microsoft Entra ID (Azure AD)](https://docs.netbird.io/how-to/microsoft-entra-id-sync). | ||
|
||
Next, locate the user you want to offboard in your IdP's user management section. Let’s say you want to revoke access to | ||
`user_01`, in that case, you will need to select it and click the `Delete` button as shown below. | ||
|
||
![IdP Delete User](/docs-static/img/how-to-guides/auto-offboard-users/TJWLvXL.png) | ||
|
||
After deletion, click the `Refresh` button to confirm that the user is no longer active. | ||
|
||
![IdP Confirm Deletion](/docs-static/img/how-to-guides/auto-offboard-users/LJ6QHRV.png) | ||
|
||
Wait for the NetBird integration to complete its next synchronization cycle, which usually takes 300 seconds. Alternatively, go to the `Integrations` screen in the NetBird admin console and click the corresponding integration button to manually trigger the synchronization. | ||
|
||
![NetBird Integrations Force Sync](/docs-static/img/how-to-guides/auto-offboard-users/ogiiUeT.png) | ||
|
||
Now, go to NetBird's `Users` dashboard to verify that the user is no longer listed. | ||
|
||
![NetBird Users Verification](/docs-static/img/how-to-guides/auto-offboard-users/MQ2yh6B.png) | ||
|
||
## Revoking Group Access | ||
|
||
Imagine a scenario where you have an access policy that grants all members of the `Staging` group access to resources in the `Servers` group. | ||
|
||
![NetBird Access Control](/docs-static/img/how-to-guides/auto-offboard-users/sATMbbP.png) | ||
|
||
Let's say the current project is finished, and you no longer want members of the `Staging` group to have access to the | ||
`Servers` group. One way to do this is to remove the `Staging` group from your IdP. | ||
|
||
![IdP Delete Group](/docs-static/img/how-to-guides/auto-offboard-users/TOZjFKC.png) | ||
|
||
Once the changes synchronize in NetBird, users and their group memberships will be updated; therefore, | ||
[network access associated with that group](https://docs.netbird.io/how-to/manage-network-access) will automatically be revoked. | ||
|
||
![NetBird No Group](/docs-static/img/how-to-guides/auto-offboard-users/NKabmN6.png) |
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 |
---|---|---|
@@ -0,0 +1,88 @@ | ||
# Restrict Network Access with CrowdStrike Falcon® | ||
|
||
[CrowdStrike Falcon](https://www.crowdstrike.com/platform/) is a cloud-based endpoint protection platform that provides | ||
comprehensive visibility and threat detection capabilities. CrowdStrike Falcon agent runs on your devices (endpoints), | ||
collects, and analyzes endpoint data to detect and respond to threats in real-time. The agent's presence on endpoints and data | ||
it collects can be utilized to enforce access policies and limit network access according to the "health" status of the | ||
endpoints. | ||
|
||
The integration of NetBird with CrowdStrike Falcon provides organizations with network security controls that allow | ||
only IT-managed devices running CrowdStrike to access the network. Additionally, the integration uses [CrowdStrike's Zero Trust Assessment (ZTA) score](https://www.crowdstrike.com/press-releases/crowdstrike-extends-zero-trust-to-endpoint-devices/), | ||
enabling administrators to further limit network access based on the security posture of each device. | ||
|
||
CrowdStrike's Zero Trust Assessment (ZTA) score is a numerical representation of the security posture of a device with | ||
a value ranging from 0 to 100. The score is calculated based on various factors, including the device's security configuration, | ||
software vulnerabilities, and CrowdStrike's threat intelligence data. By integrating with CrowdStrike Falcon, | ||
NetBird can ensure that only devices with a high security posture can access the network. | ||
|
||
In this guide, we will walk you through the configuration steps to integrate CrowdStrike Falcon with NetBird and use ZTA score | ||
to allow network access to devices that meet a specified ZTA threshold. | ||
|
||
## Prerequisites | ||
|
||
Before you start creating and configuring a CrowdStrike integration, ensure that you have the following: | ||
- A CrowdStrike account with the permissions to create and manage API keys. | ||
If you don't have the required permissions, ask your CrowdStrike administrator to grant them to you. | ||
|
||
## Create a CrowdStrike API Key | ||
|
||
- Navigate to the [API clients and keys](https://falcon.eu-1.crowdstrike.com/api-clients-and-keys/) page | ||
- Click `Create API client` at the top, right corner | ||
- Set Hosts - Read permission | ||
- Set Zero Trust Assessment - Read permission | ||
- Click `Create` | ||
- Copy the credentials. You will need these credentials when configuring an integration in NetBird. | ||
|
||
## Configure a CrowdStrike Integration in NetBird | ||
|
||
- Navigate to the [Integrations » EDR](https://app.netbird.io/integrations?tab=edr) tab in the NetBird dashboard | ||
- Click `Connect CrowdStrike` to start the configuration wizard | ||
<p> | ||
<img src="/docs-static/img/how-to-guides/crowdstrike-integration.png" alt="event-streaming-integration" className="imagewrapper-big"/> | ||
</p> | ||
|
||
- First, select the region of your CrowdStrike account | ||
<p> | ||
<img src="/docs-static/img/how-to-guides/crowdstrike-region.png" alt="crowdstrike-region" className="imagewrapper"/> | ||
</p> | ||
- Then enter the client ID and secret key you created in [Step 1](#step-1-create-a-crowd-strike-api-key) and click `Continue` | ||
<p> | ||
<img src="/docs-static/img/how-to-guides/crowdstrike-credentials.png" alt="crowdstrike-credentials" className="imagewrapper"/> | ||
</p> | ||
- Select groups you want to apply the integration to | ||
- If you would like to apply a ZTA threshold, then enable the [Zero Trust Assessment Score](https://www.crowdstrike.com/blog/tech-center/securing-private-applications-with-crowdstrike-zero-trust-assessment-and-aws-verified-access/) and set the desired limit, and click `Connect`. | ||
<p> | ||
<img src="/docs-static/img/how-to-guides/crowdstrike-groups-zta.png" alt="crowdstrike-groups-zta" className="imagewrapper"/> | ||
</p> | ||
|
||
<Note> | ||
The EDR check will apply only to machines in the selected groups and will require a running CrowdStrike agent. | ||
</Note> | ||
<Note> | ||
You can also use groups [synchronized from your Identity Provider (IdP)](/how-to/idp-sync). | ||
</Note> | ||
|
||
- Peers that have the CrowdStrike agent installed will be granted access to the network. Peers without the agent will appear | ||
with a `Approval required` mark in the peers list and won't be able to access the network until the agent is installed. | ||
|
||
<p> | ||
<img src="/docs-static/img/how-to-guides/edr-approval-required.png" alt="edr-approval-required" className="imagewrapper-big"/> | ||
</p> | ||
|
||
- Optional. You can experiment and see how the integration works by hiding hosts in the CrowdStrike Host management console: | ||
- Navigate to the [Host management](https://falcon.crowdstrike.com/host-management/hosts) page in the CrowdStrike console | ||
- Select a host you want to hide | ||
- Click `Actions` and then `Hide` | ||
- The host will be moved to Trash (you can restore it later) | ||
- After about a minute, the peer will be disconnected from the network and marked as `Approval required` in the NetBird dashboard. | ||
- To restore the host in CrowdStrike, navigate to the Trash and click `Restore` | ||
|
||
<Note> | ||
NetBird synchronizes the list of devices managed by the EDR platform via the API about every minute. | ||
The changes might not be visible immediately. | ||
</Note> | ||
|
||
<Note> | ||
If you install the CrowdStrike agent on a peer after it joined the network, you will need to disconnect and reconnect | ||
this peer for the `Approval required` mark to disappear. | ||
</Note> |
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