sendnrw/netbird-docs
2
0
Fork 0
mirror of https://github.com/netbirdio/docs.git synced 2026-04-18 16:36:35 +00:00
Code Issues Packages Projects Releases Wiki Activity

Extend IdP sync API docs with user/group filters (#130)

Browse Source
This commit is contained in:
Yury Gargay
2024-01-15 17:32:24 +01:00
committed by GitHub
parent ba2d7c7ef4
commit e6ee8ec034
1 changed files with 50 additions and 22 deletions
Download Patch File Download Diff File Expand all files Collapse all files

50
misc/idp-sync/api.md
View File

@@ -17,8 +17,9 @@ Request:
```shell
base64 -i <SERVICE_ACCOUNT_KEY_PATH>
```
- `sync_interval`: Optional. The default value is 300 seconds.
- `group_prefixes`: Specifies list of starts_with patterns for group provision. If the group name matches one the the pattern it will be provisioned regardless of the members. Optional. The default value is empty list.
- `user_group_prefixes`: Specifies list of starts_with patterns for user provision. If the user belongs to group which name matches one the the pattern the user will be provisioned. Optional. The default value is empty list.
```shell
curl --request POST \
@@ -28,7 +29,9 @@ curl --request POST \
--header 'Content-Type: application/json' \
--data '{
"service_account_key": "<SERVICE_ACCOUNT_KEY>",
"customerID": "<CUSTOMER_ID>"
"customerID": "<CUSTOMER_ID>",
"group_prefixes": [],
"user_group_prefixes": []
}'
```
@@ -38,7 +41,9 @@ Response
"id": <ID>,
"customer_id": "<CUSTOMER_ID",
"sync_interval": 300,
"enabled": true
"enabled": true,
"group_prefixes": [],
"user_group_prefixes": []
}
```
@@ -57,7 +62,9 @@ Response
"id": <ID>,
"customer_id": "<CUSTOMER_ID",
"sync_interval": 300,
"enabled": true
"enabled": true,
"group_prefixes": [],
"user_group_prefixes": []
}
```
@@ -77,7 +84,9 @@ Response
"id": <ID>,
"customer_id": "<CUSTOMER_ID>",
"sync_interval": 300,
"enabled": true
"enabled": true,
"group_prefixes": [],
"user_group_prefixes": []
}
]
```
@@ -108,6 +117,8 @@ Request
base64 -i <SERVICE_ACCOUNT_KEY_PATH>
```
- `sync_interval`: Optional. Should not be less than 300 seconds.
- `group_prefixes`: Specifies list of starts_with patterns for group provision. If the group name matches one the the pattern it will be provisioned regardless of the members. Optional. The default value is empty list.
- `user_group_prefixes`: Specifies list of starts_with patterns for user provision. If the user belongs to group which name matches one the the pattern the user will be provisioned. Optional. The default value is empty list.
- `enabled`: Optional. Used to disable/enable the integration.
```shell
@@ -119,7 +130,9 @@ curl --request PUT \
--data '{
"service_account_key": "<SERVICE_ACCOUNT_KEY>",
"sync_interval": 300,
"enabled": false
"enabled": false,
"group_prefixes": [],
"user_group_prefixes": []
}'
```
@@ -129,7 +142,9 @@ Response
"id": <ID>,
"customer_id": "<CUSTOMER_ID>",
"sync_interval": 300,
"enabled": false
"enabled": false,
"group_prefixes": [],
"user_group_prefixes": []
}
```
@@ -182,6 +197,9 @@ Request:
- `client_id`: Azure Directory application client Id.
- `tenant_id`: Azure Directory ID.
- `sync_interval`: Optional. The default value is 300 seconds.
- `group_prefixes`: Specifies list of starts_with patterns for group provision. If the group name matches one the the pattern it will be provisioned regardless of the members. Optional. The default value is empty list.
- `user_group_prefixes`: Specifies list of starts_with patterns for user provision. If the user belongs to group which name matches one the the pattern the user will be provisioned. Optional. The default value is empty list.
- `enabled`: Optional. Used to disable/enable the integration.
```shell
curl --request POST \
@@ -192,7 +210,9 @@ curl --request POST \
--data '{
"client_secret": "<CLIENT_SECRET>",
"client_id": "<CLIENT_ID>",
"tenant_id": "<TENANT_ID>"
"tenant_id": "<TENANT_ID>",
"group_prefixes": [],
"user_group_prefixes": []
}'
```
@@ -223,7 +243,9 @@ Response
"client_id": "<CLIENT_ID>",
"tenant_id": "<TENANT_ID>",
"sync_interval": 300,
"enabled": true
"enabled": true,
"group_prefixes": [],
"user_group_prefixes": []
}
```
@@ -244,7 +266,9 @@ Response
"client_id": "<CLIENT_ID>",
"tenant_id": "<TENANT_ID>",
"sync_interval": 300,
"enabled": true
"enabled": true,
"group_prefixes": [],
"user_group_prefixes": []
}
]
```
@@ -275,6 +299,8 @@ Request
echo -n <CLIENT_SECRET> | base64
```
- `sync_interval`: Optional. Should not be less than 300 seconds.
- `group_prefixes`: Specifies list of starts_with patterns for group provision. If the group name matches one the the pattern it will be provisioned regardless of the members. Optional. The default value is empty list.
- `user_group_prefixes`: Specifies list of starts_with patterns for user provision. If the user belongs to group which name matches one the the pattern the user will be provisioned. Optional. The default value is empty list.
- `enabled`: Optional. Used to disable/enable the integration.
```shell
@@ -297,7 +323,9 @@ Response
"client_id": "<CLIENT_ID>",
"tenant_id": "<TENANT_ID>",
"sync_interval": 300,
"enabled": true
"enabled": true,
"group_prefixes": [],
"user_group_prefixes": []
}
```