mirror of
https://github.com/LukeHagar/developer.sailpoint.com.git
synced 2025-12-08 12:27:47 +00:00
starting point for adding python sdk docs
This commit is contained in:
darrell-thobe-sp
@@ -0,0 +1,155 @@
|
||||
---
|
||||
id: beta-public-identities-config
|
||||
title: Public_Identities_Config
|
||||
pagination_label: Public_Identities_Config
|
||||
sidebar_label: Public_Identities_Config
|
||||
sidebar_class_name: pythonsdk
|
||||
keywords: ['python', 'Python', 'sdk', 'Public_Identities_Config', 'BetaPublic_Identities_Config']
|
||||
slug: /tools/sdk/python/beta/methods/public-identities-config
|
||||
tags: ['SDK', 'Software Development Kit', 'Public_Identities_Config', 'BetaPublic_Identities_Config']
|
||||
---
|
||||
|
||||
# sailpoint.beta.PublicIdentitiesConfigApi
|
||||
Use this API to implement public identity configuration functionality.
|
||||
With this functionality in place, administrators can make up to 5 identity attributes publicly visible so other non-administrator users can see the relevant information they need to make decisions.
|
||||
This can be helpful for access approvers, certification reviewers, managers viewing their direct reports' access, and source owners viewing their tasks.
|
||||
|
||||
By default, non-administrators can select an identity and view the following attributes: email, lifecycle state, and manager.
|
||||
However, it may be helpful for a non-administrator reviewer to see other identity attributes like department, region, title, etc.
|
||||
Administrators can use this API to make those necessary identity attributes public to non-administrators.
|
||||
|
||||
For example, a non-administrator deciding whether to approve another identity's request for access to the Workday application, whose access may be restricted to members of the HR department, would want to know whether the identity is a member of the HR department.
|
||||
If an administrator has used [Update Public Identity Config](https://developer.sailpoint.com/docs/api/beta/update-public-identity-config/) to make the "department" attribute public, the approver can see the department and make a decision without requesting any more information.
|
||||
|
||||
All URIs are relative to *https://sailpoint.api.identitynow.com/beta*
|
||||
|
||||
Method | HTTP request | Description
|
||||
------------- | ------------- | -------------
|
||||
[**get_public_identity_config**](PublicIdentitiesConfigApi#get-public-identity-config) | **GET** `/public-identities-config` | Get Public Identity Config
|
||||
[**update_public_identity_config**](PublicIdentitiesConfigApi#update-public-identity-config) | **PUT** `/public-identities-config` | Update Public Identity Config
|
||||
|
||||
|
||||
## get-public-identity-config
|
||||
Get Public Identity Config
|
||||
This gets details of public identity config.
|
||||
|
||||
[API Spec](https://developer.sailpoint.com/docs/api/beta/get-public-identity-config)
|
||||
|
||||
### Parameters
|
||||
This endpoint does not need any parameter.
|
||||
|
||||
### Return type
|
||||
[**PublicIdentityConfig**](../models/public-identity-config)
|
||||
|
||||
### Responses
|
||||
Code | Description | Data Type | Response headers |
|
||||
------------- | ------------- | ------------- |------------------|
|
||||
200 | Request succeeded. | PublicIdentityConfig | - |
|
||||
400 | Client Error - Returned if the request body is invalid. | ErrorResponseDto | - |
|
||||
401 | Unauthorized - Returned if there is no authorization header, or if the JWT token is expired. | ListAccessModelMetadataAttribute401Response | - |
|
||||
403 | Forbidden - Returned if the user you are running as, doesn't have access to this end-point. | ErrorResponseDto | - |
|
||||
429 | Too Many Requests - Returned in response to too many requests in a given period of time - rate limited. The Retry-After header in the response includes how long to wait before trying again. | ListAccessModelMetadataAttribute429Response | - |
|
||||
500 | Internal Server Error - Returned if there is an unexpected error. | ErrorResponseDto | - |
|
||||
|
||||
### HTTP request headers
|
||||
- **Content-Type**: Not defined
|
||||
- **Accept**: application/json
|
||||
|
||||
### Example
|
||||
|
||||
```python
|
||||
import sailpoint.beta
|
||||
from sailpoint.beta.models.public_identity_config import PublicIdentityConfig
|
||||
from sailpoint.beta.rest import ApiException
|
||||
from pprint import pprint
|
||||
|
||||
|
||||
try:
|
||||
# Get Public Identity Config
|
||||
|
||||
api_response = api_instance.get_public_identity_config()
|
||||
|
||||
# Below is a request that includes all optional parameters
|
||||
# api_response = api_instance.get_public_identity_config()
|
||||
print("The response of PublicIdentitiesConfigApi->get_public_identity_config:\n")
|
||||
pprint(api_response)
|
||||
except Exception as e:
|
||||
print("Exception when calling PublicIdentitiesConfigApi->get_public_identity_config: %s\n" % e)
|
||||
```
|
||||
|
||||
|
||||
|
||||
[[Back to top]](#)
|
||||
|
||||
## update-public-identity-config
|
||||
Update Public Identity Config
|
||||
This updates the details of public identity config.
|
||||
|
||||
[API Spec](https://developer.sailpoint.com/docs/api/beta/update-public-identity-config)
|
||||
|
||||
### Parameters
|
||||
|
||||
Param Type | Name | Data Type | Required | Description
|
||||
------------- | ------------- | ------------- | ------------- | -------------
|
||||
Body | public_identity_config | [**PublicIdentityConfig**](../models/public-identity-config) | True |
|
||||
|
||||
### Return type
|
||||
[**PublicIdentityConfig**](../models/public-identity-config)
|
||||
|
||||
### Responses
|
||||
Code | Description | Data Type | Response headers |
|
||||
------------- | ------------- | ------------- |------------------|
|
||||
200 | Request succeeded. | PublicIdentityConfig | - |
|
||||
400 | Client Error - Returned if the request body is invalid. | ErrorResponseDto | - |
|
||||
401 | Unauthorized - Returned if there is no authorization header, or if the JWT token is expired. | ListAccessModelMetadataAttribute401Response | - |
|
||||
403 | Forbidden - Returned if the user you are running as, doesn't have access to this end-point. | ErrorResponseDto | - |
|
||||
429 | Too Many Requests - Returned in response to too many requests in a given period of time - rate limited. The Retry-After header in the response includes how long to wait before trying again. | ListAccessModelMetadataAttribute429Response | - |
|
||||
500 | Internal Server Error - Returned if there is an unexpected error. | ErrorResponseDto | - |
|
||||
|
||||
### HTTP request headers
|
||||
- **Content-Type**: application/json
|
||||
- **Accept**: application/json
|
||||
|
||||
### Example
|
||||
|
||||
```python
|
||||
import sailpoint.beta
|
||||
from sailpoint.beta.models.public_identity_config import PublicIdentityConfig
|
||||
from sailpoint.beta.rest import ApiException
|
||||
from pprint import pprint
|
||||
|
||||
public_identity_config = {
|
||||
"modified" : "2018-06-25T20:22:28.104Z",
|
||||
"attributes" : [ {
|
||||
"name" : "Country",
|
||||
"key" : "country"
|
||||
}, {
|
||||
"name" : "Country",
|
||||
"key" : "country"
|
||||
} ],
|
||||
"modifiedBy" : {
|
||||
"name" : "Thomas Edison",
|
||||
"id" : "2c9180a46faadee4016fb4e018c20639",
|
||||
"type" : "IDENTITY"
|
||||
}
|
||||
} # PublicIdentityConfig |
|
||||
|
||||
try:
|
||||
# Update Public Identity Config
|
||||
Result = public_identity_config.from_json(public_identity_config)
|
||||
api_response = api_instance.update_public_identity_config(Result)
|
||||
|
||||
# Below is a request that includes all optional parameters
|
||||
# api_response = api_instance.update_public_identity_config(Result)
|
||||
print("The response of PublicIdentitiesConfigApi->update_public_identity_config:\n")
|
||||
pprint(api_response)
|
||||
except Exception as e:
|
||||
print("Exception when calling PublicIdentitiesConfigApi->update_public_identity_config: %s\n" % e)
|
||||
```
|
||||
|
||||
|
||||
|
||||
[[Back to top]](#)
|
||||
|
||||
|
||||
|
||||
Reference in New Issue
Block a user