Package com.okta.sdk.resource.api
Class ApplicationUsersApi
java.lang.Object
com.okta.sdk.resource.api.ApplicationUsersApi
@Generated(value="org.openapitools.codegen.languages.JavaClientCodegen",
date="2024-08-09T14:19:33.269913-05:00[America/Chicago]",
comments="Generator version: 7.7.0")
public class ApplicationUsersApi
extends Object
-
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionassignUserToApplication
(String appId, AppUserAssignRequest appUser) Assign an Application User Assigns a user to an app for: * SSO only<br> Assignments to SSO apps typically don't include a user profile.assignUserToApplication
(String appId, AppUserAssignRequest appUser, Map<String, String> additionalHeaders) Assign an Application User Assigns a user to an app for: * SSO only<br> Assignments to SSO apps typically don't include a user profile.getApplicationUser
(String appId, String userId, String expand) Retrieve an Application User Retrieves a specific user assignment for a specific appgetApplicationUser
(String appId, String userId, String expand, Map<String, String> additionalHeaders) Retrieve an Application User Retrieves a specific user assignment for a specific appprotected static com.fasterxml.jackson.databind.ObjectMapper
List all Application Users Lists all assigned users for an applistApplicationUsers
(String appId, String after, Integer limit, String q, String expand, Map<String, String> additionalHeaders) List all Application Users Lists all assigned users for an appvoid
setApiClient
(ApiClient apiClient) void
unassignUserFromApplication
(String appId, String userId, Boolean sendEmail) Unassign an Application User Unassigns a user from an app For directories like Active Directory and LDAP, they act as the owner of the user's credential with Okta delegating authentication (DelAuth) to that directory.void
unassignUserFromApplication
(String appId, String userId, Boolean sendEmail, Map<String, String> additionalHeaders) Unassign an Application User Unassigns a user from an app For directories like Active Directory and LDAP, they act as the owner of the user's credential with Okta delegating authentication (DelAuth) to that directory.updateApplicationUser
(String appId, String userId, AppUserUpdateRequest appUser) Update an Application User Updates the profile or credentials of a user assigned to an appupdateApplicationUser
(String appId, String userId, AppUserUpdateRequest appUser, Map<String, String> additionalHeaders) Update an Application User Updates the profile or credentials of a user assigned to an app
-
Constructor Details
-
ApplicationUsersApi
public ApplicationUsersApi() -
ApplicationUsersApi
-
-
Method Details
-
getApiClient
-
setApiClient
-
assignUserToApplication
public AppUser assignUserToApplication(String appId, AppUserAssignRequest appUser) throws ApiException Assign an Application User Assigns a user to an app for: * SSO only<br> Assignments to SSO apps typically don't include a user profile. However, if your SSO app requires a profile but doesn't have provisioning enabled, you can add profile attributes in the request body. * SSO and provisioning<br> Assignments to SSO and provisioning apps typically include credentials and an app-specific profile. Profile mappings defined for the app are applied first before applying any profile properties that are specified in the request body. > **Notes:** > * When Universal Directory is enabled, you can only specify profile properties that aren't defined in profile mappings. > * Omit mapped properties during assignment to minimize assignment errors.- Parameters:
appId
- Application ID (required)appUser
- (required)- Returns:
- AppUser
- Throws:
ApiException
- if fails to make API call
-
assignUserToApplication
public AppUser assignUserToApplication(String appId, AppUserAssignRequest appUser, Map<String, String> additionalHeaders) throws ApiExceptionAssign an Application User Assigns a user to an app for: * SSO only<br> Assignments to SSO apps typically don't include a user profile. However, if your SSO app requires a profile but doesn't have provisioning enabled, you can add profile attributes in the request body. * SSO and provisioning<br> Assignments to SSO and provisioning apps typically include credentials and an app-specific profile. Profile mappings defined for the app are applied first before applying any profile properties that are specified in the request body. > **Notes:** > * When Universal Directory is enabled, you can only specify profile properties that aren't defined in profile mappings. > * Omit mapped properties during assignment to minimize assignment errors.- Parameters:
appId
- Application ID (required)appUser
- (required)additionalHeaders
- additionalHeaders for this call- Returns:
- AppUser
- Throws:
ApiException
- if fails to make API call
-
getApplicationUser
Retrieve an Application User Retrieves a specific user assignment for a specific app- Parameters:
appId
- Application ID (required)userId
- ID of an existing Okta user (required)expand
- An optional query parameter to return the corresponding [User](/openapi/okta-management/management/tag/User/) object in the `_embedded` property. Valid value: `user` (optional)- Returns:
- AppUser
- Throws:
ApiException
- if fails to make API call
-
getApplicationUser
public AppUser getApplicationUser(String appId, String userId, String expand, Map<String, String> additionalHeaders) throws ApiExceptionRetrieve an Application User Retrieves a specific user assignment for a specific app- Parameters:
appId
- Application ID (required)userId
- ID of an existing Okta user (required)expand
- An optional query parameter to return the corresponding [User](/openapi/okta-management/management/tag/User/) object in the `_embedded` property. Valid value: `user` (optional)additionalHeaders
- additionalHeaders for this call- Returns:
- AppUser
- Throws:
ApiException
- if fails to make API call
-
listApplicationUsers
public List<AppUser> listApplicationUsers(String appId, String after, Integer limit, String q, String expand) throws ApiException List all Application Users Lists all assigned users for an app- Parameters:
appId
- Application ID (required)after
- Specifies the pagination cursor for the next page of results. Treat this as an opaque value obtained through the next link relationship. See [Pagination](/#pagination). (optional)limit
- Specifies the number of objects to return per page. If there are multiple pages of results, the Link header contains a `next` link that you need to use as an opaque value (follow it, don't parse it). See [Pagination](/#pagination). (optional, default to 50)q
- Specifies a filter for the list of Application Users returned based on their profile attributes. The value of `q` is matched against the beginning of the following profile attributes: `userName`, `firstName`, `lastName`, and `email`. This filter only supports the `startsWith` operation that matches the `q` string against the beginning of the attribute values. > **Note:** For OIDC apps, user profiles don't contain the `firstName` or `lastName` attributes. Therefore, the query only matches against the `userName` or `email` attributes. (optional)expand
- An optional query parameter to return the corresponding [User](/openapi/okta-management/management/tag/User/) object in the `_embedded` property. Valid value: `user` (optional)- Returns:
- List<AppUser>
- Throws:
ApiException
- if fails to make API call
-
listApplicationUsers
public List<AppUser> listApplicationUsers(String appId, String after, Integer limit, String q, String expand, Map<String, String> additionalHeaders) throws ApiExceptionList all Application Users Lists all assigned users for an app- Parameters:
appId
- Application ID (required)after
- Specifies the pagination cursor for the next page of results. Treat this as an opaque value obtained through the next link relationship. See [Pagination](/#pagination). (optional)limit
- Specifies the number of objects to return per page. If there are multiple pages of results, the Link header contains a `next` link that you need to use as an opaque value (follow it, don't parse it). See [Pagination](/#pagination). (optional, default to 50)q
- Specifies a filter for the list of Application Users returned based on their profile attributes. The value of `q` is matched against the beginning of the following profile attributes: `userName`, `firstName`, `lastName`, and `email`. This filter only supports the `startsWith` operation that matches the `q` string against the beginning of the attribute values. > **Note:** For OIDC apps, user profiles don't contain the `firstName` or `lastName` attributes. Therefore, the query only matches against the `userName` or `email` attributes. (optional)expand
- An optional query parameter to return the corresponding [User](/openapi/okta-management/management/tag/User/) object in the `_embedded` property. Valid value: `user` (optional)additionalHeaders
- additionalHeaders for this call- Returns:
- List<AppUser>
- Throws:
ApiException
- if fails to make API call
-
unassignUserFromApplication
public void unassignUserFromApplication(String appId, String userId, Boolean sendEmail) throws ApiException Unassign an Application User Unassigns a user from an app For directories like Active Directory and LDAP, they act as the owner of the user's credential with Okta delegating authentication (DelAuth) to that directory. If this request is successful for a user when DelAuth is enabled, then the user is in a state with no password. You can then reset the user's password. > **Important:** This is a destructive operation. You can't recover the user's app profile. If the app is enabled for provisioning and configured to deactivate users, the user is also deactivated in the target app.- Parameters:
appId
- Application ID (required)userId
- ID of an existing Okta user (required)sendEmail
- Sends a deactivation email to the administrator if `true` (optional, default to false)- Throws:
ApiException
- if fails to make API call
-
unassignUserFromApplication
public void unassignUserFromApplication(String appId, String userId, Boolean sendEmail, Map<String, String> additionalHeaders) throws ApiExceptionUnassign an Application User Unassigns a user from an app For directories like Active Directory and LDAP, they act as the owner of the user's credential with Okta delegating authentication (DelAuth) to that directory. If this request is successful for a user when DelAuth is enabled, then the user is in a state with no password. You can then reset the user's password. > **Important:** This is a destructive operation. You can't recover the user's app profile. If the app is enabled for provisioning and configured to deactivate users, the user is also deactivated in the target app.- Parameters:
appId
- Application ID (required)userId
- ID of an existing Okta user (required)sendEmail
- Sends a deactivation email to the administrator if `true` (optional, default to false)additionalHeaders
- additionalHeaders for this call- Throws:
ApiException
- if fails to make API call
-
updateApplicationUser
public AppUser updateApplicationUser(String appId, String userId, AppUserUpdateRequest appUser) throws ApiException Update an Application User Updates the profile or credentials of a user assigned to an app- Parameters:
appId
- Application ID (required)userId
- ID of an existing Okta user (required)appUser
- (required)- Returns:
- AppUser
- Throws:
ApiException
- if fails to make API call
-
updateApplicationUser
public AppUser updateApplicationUser(String appId, String userId, AppUserUpdateRequest appUser, Map<String, String> additionalHeaders) throws ApiExceptionUpdate an Application User Updates the profile or credentials of a user assigned to an app- Parameters:
appId
- Application ID (required)userId
- ID of an existing Okta user (required)appUser
- (required)additionalHeaders
- additionalHeaders for this call- Returns:
- AppUser
- Throws:
ApiException
- if fails to make API call
-
getObjectMapper
protected static com.fasterxml.jackson.databind.ObjectMapper getObjectMapper()
-