Login Configurations
Install Dependency
Package: AffinidiTdk.LoginConfigurationClient
dotnet add package AffinidiTdk.LoginConfigurationClient
You can check the latest version of this module on the nuget.org repository or view the source code at the GitHub repository.
Classes and Methods
Configurations API
Use to manage Login Configuration to integrate Affinidi Login.
CreateLoginConfigurations
Create a new Login Configuration to integrate Affinidi Login.
Parameters
CreateLoginConfigurationInput [Object]
JSON object to provide the configuration details of the application. See more here.
Example
using AffinidiTdk.LoginConfigurationClient.Api;
using AffinidiTdk.LoginConfigurationClient.Client;
using AffinidiTdk.LoginConfigurationClient.Model;
Configuration config = new Configuration();
config.AddApiKey("authorization", projectScopedToken);
ConfigurationApi configApi = new ConfigurationApi(config);
var loginConfigInput = new CreateLoginConfigurationInput(name: "DotNet App", redirectUris: ["http://localhost:3000/auth/callback"]);
CreateLoginConfigurationOutput result = configApi.CreateLoginConfigurations(loginConfigInput);
DeleteLoginConfigurationsById
Delete an existing Login Configuration by ID.
Parameters
configurationId [String]
ID of the Login Configuration to delete.
Example
using AffinidiTdk.LoginConfigurationClient.Api;
using AffinidiTdk.LoginConfigurationClient.Client;
// Pass the projectScopedToken generated from AuthProvider package
Configuration config = new Configuration();
config.AddApiKey("authorization", projectScopedToken);
ConfigurationApi configApi = new ConfigurationApi(config);
var configurationID = "<CONFIG-ID>";
configApi.DeleteLoginConfigurationsById(configurationID);
GetClientMetadataByClientId
Retrieves the Client Metadata info of the Login Configuration by OAuth 2.0 Client ID.
Parameters
clientId [String]
OAuth 2.0 Client ID generated by Login Configuration.
Example
using AffinidiTdk.LoginConfigurationClient.Api;
using AffinidiTdk.LoginConfigurationClient.Client;
using AffinidiTdk.LoginConfigurationClient.Model;
Configuration config = new Configuration();
config.AddApiKey("authorization", projectScopedToken);
ConfigurationApi configApi = new ConfigurationApi(config);
var configurationID = "<CONFIG-ID>";
LoginConfigurationClientMetadataOutput result = configApi.GetClientMetadataByClientId(configurationId);
GetLoginConfigurationsById
Retrieves the Login Configuration details by ID.
Parameters
configurationId [String]
ID of the existing Login Configuration to retrieve.
Example
using AffinidiTdk.LoginConfigurationClient.Api;
using AffinidiTdk.LoginConfigurationClient.Client;
using AffinidiTdk.LoginConfigurationClient.Model;
Configuration config = new Configuration();
config.AddApiKey("authorization", projectScopedToken);
ConfigurationApi configApi = new ConfigurationApi(config);
var configurationID = "<CONFIG-ID>";
LoginConfigurationObject result = configApi.GetLoginConfigurationsById(configurationID);
ListLoginConfigurations
List all the Login Configurations in the Project.
Parameters
limit [Integer]
Maximum number of records to fetch from the list.
exclusiveStartKey [String]
The base64url encoded key of the first item that this operation will evaluate (it is not returned). Use the value that was returned in the previous operation.
Example
using AffinidiTdk.LoginConfigurationClient.Api;
using AffinidiTdk.LoginConfigurationClient.Client;
using AffinidiTdk.LoginConfigurationClient.Model;
Configuration config = new Configuration();
config.AddApiKey("authorization", projectScopedToken);
ConfigurationApi configApi = new ConfigurationApi(config);
ListLoginConfigurationOutput result = configApi.ListLoginConfigurations();
UpdateLoginConfigurationsById
Update an existing Login Configuration by ID
Parameters
configurationId [String]
ID of the Login Configuration to update.
UpdateLoginConfigurationInput [Object]
JSON object to provide to update the Login Configuration details. See more here.
Example
using AffinidiTdk.LoginConfigurationClient.Api;
using AffinidiTdk.LoginConfigurationClient.Client;
using AffinidiTdk.LoginConfigurationClient.Model;
Configuration config = new Configuration();
config.AddApiKey("authorization", projectScopedToken);
ConfigurationApi configApi = new ConfigurationApi(config);
string configId = "<CONFIG_ID>";
UpdateLoginConfigurationInput input = new UpdateLoginConfigurationInput(name: "Sample App");
LoginConfigurationObject result = configApi.UpdateLoginConfigurationsById(configId, input);
Group API
Used to manage the User Groups for the Project.
AddUserToGroup
Add user to the user group.
Parameters
groupName [String]
Name of the group to add the user.
AddUserToGroupInput [Object]
JSON object to provide with the ID of the user to add. See more here.
Example
using AffinidiTdk.LoginConfigurationClient.Api;
using AffinidiTdk.LoginConfigurationClient.Client;
using AffinidiTdk.LoginConfigurationClient.Model;
Configuration config = new Configuration();
config.AddApiKey("authorization", projectScopedToken);
GroupApi groupApi = new GroupApi(config);
string groupName = "<GROUP-NAME>"
AddUserToGroupInput input = new AddUserToGroupInput(userId: "<USER-DID>");
GroupUserMappingDto result = groupApi.AddUserToGroup(groupName, input);
CreateGroup
Create a user group.
Parameters
CreateGroupInput [Object]
JSON object to provide the name of the user group.
Example
using AffinidiTdk.LoginConfigurationClient.Api;
using AffinidiTdk.LoginConfigurationClient.Client;
using AffinidiTdk.LoginConfigurationClient.Model;
Configuration config = new Configuration();
config.AddApiKey("authorization", projectScopedToken);
GroupApi groupApi = new GroupApi(config);
CreateGroupInput input = new CreateGroupInput(groupName: "<GROUP_NAME>");
GroupDto result = groupApi.CreateGroup(input);
DeleteGroup
Delete a group by name.
Parameters
groupName [String]
Name of the group to delete.
Example
using AffinidiTdk.LoginConfigurationClient.Api;
using AffinidiTdk.LoginConfigurationClient.Client;
using AffinidiTdk.LoginConfigurationClient.Model;
Configuration config = new Configuration();
config.AddApiKey("authorization", projectScopedToken);
GroupApi groupApi = new GroupApi(config);
groupApi.DeleteGroup("<GROUP_NAME>");
GetGroupById
Retrieve a group by the group name.
Parameters
groupName [String]
Name of the group to retrieve.
Example
using AffinidiTdk.LoginConfigurationClient.Api;
using AffinidiTdk.LoginConfigurationClient.Client;
using AffinidiTdk.LoginConfigurationClient.Model;
Configuration config = new Configuration();
config.AddApiKey("authorization", projectScopedToken);
GroupApi groupApi = new GroupApi(config);
GroupDto result = groupApi.GetGroupById("<GROUP_NAME>");
ListGroupUserMappings
List all the users from the group.
Parameters
groupName [String]
Name of the group to list.
limit [Integer]
Maximum number of records to fetch in a list.
exclusiveStartKey [String]
The base64url encoded key of the first item that this operation will evaluate (it is not returned). Use the value that was returned in the previous operation.
sortOrder [String]
sort response in specific order. By default it is in desc order.
Example
using AffinidiTdk.LoginConfigurationClient.Api;
using AffinidiTdk.LoginConfigurationClient.Client;
using AffinidiTdk.LoginConfigurationClient.Model;
Configuration config = new Configuration();
config.AddApiKey("authorization", projectScopedToken);
GroupApi groupApi = new GroupApi(config);
GroupUserMappingsList result = groupApi.ListGroupUserMappings("<GROUP_NAME>");
ListGroups
List all the groups in the Project.
Parameters
No Parameters Required
Example
using AffinidiTdk.LoginConfigurationClient.Api;
using AffinidiTdk.LoginConfigurationClient.Client;
using AffinidiTdk.LoginConfigurationClient.Model;
Configuration config = new Configuration();
config.AddApiKey("authorization", projectScopedToken);
GroupApi groupApi = new GroupApi(config);
GroupsList result = groupApi.ListGroups();
RemoveUserFromGroupInput
Remove user from the group.
Parameters
groupName [String]
Name of the group where the user will be removed.
RemoveUserFromGroupInput [Object]
JSON object to provide the ID of the user to remove. See more here.
Example
using AffinidiTdk.LoginConfigurationClient.Api;
using AffinidiTdk.LoginConfigurationClient.Client;
using AffinidiTdk.LoginConfigurationClient.Model;
Configuration config = new Configuration();
config.AddApiKey("authorization", projectScopedToken);
GroupApi groupApi = new GroupApi(config);
RemoveUserFromGroupInput input = new RemoveUserFromGroupInput("did:key:890890890890890");
DenyList API
Used to block groups and users to deny access on services like Affinidi Login when users are authenticating.
BlockGroups
Block users by group.
Parameters
GroupNamesInput [Object]
List of groups to block. See more here.
Example
using AffinidiTdk.LoginConfigurationClient.Api;
using AffinidiTdk.LoginConfigurationClient.Client;
using AffinidiTdk.LoginConfigurationClient.Model;
Configuration config = new Configuration();
config.AddApiKey("authorization", projectScopedToken);
DenyListApi denyListApi = new DenyListApi(config);
List<string> groupNames = ["<GROUP-NAME>"];
GroupNamesInput input = new GroupNamesInput(groupNames);
denyListApi.BlockGroups(input);
BlockUsers
Block by User ID (DID).
Parameters
BlockedUsersInput [Object]
List of User IDs (DIDs) to block. See more here.
Example
using AffinidiTdk.LoginConfigurationClient.Api;
using AffinidiTdk.LoginConfigurationClient.Client;
using AffinidiTdk.LoginConfigurationClient.Model;
Configuration config = new Configuration();
config.AddApiKey("authorization", projectScopedToken);
DenyListApi denyListApi = new DenyListApi(config);
List<string> userDidList = ["did:key..."];
BlockedUsersInput input = new blockedUsersInput(userIds: userDidList);
denyListApi.BlockUsers(input);
ListBlockedGroups
Get list of blocked groups.
Parameters
pageToken [String]
Used for pagination.
Example
using AffinidiTdk.LoginConfigurationClient.Api;
using AffinidiTdk.LoginConfigurationClient.Client;
using AffinidiTdk.LoginConfigurationClient.Model;
Configuration config = new Configuration();
config.AddApiKey("authorization", projectScopedToken);
DenyListApi denyListApi = new DenyListApi(config);
GroupNames result = denyListApi.ListBlockedGroups();
ListBlockedUsers
Get list of blocked users.
Parameters
pageToken [String]
Used for pagination.
Example
using AffinidiTdk.LoginConfigurationClient.Api;
using AffinidiTdk.LoginConfigurationClient.Client;
using AffinidiTdk.LoginConfigurationClient.Model;
Configuration config = new Configuration();
config.AddApiKey("authorization", projectScopedToken);
DenyListApi denyListApi = new DenyListApi(config);
BlockedUsers result = denyListApi.ListBlockedUsers();
UnblockGroups
Unblock users by group.
Parameters
GroupNamesInput [Object]
List of groups to block. See more here.
Example
using AffinidiTdk.LoginConfigurationClient.Api;
using AffinidiTdk.LoginConfigurationClient.Client;
using AffinidiTdk.LoginConfigurationClient.Model;
Configuration config = new Configuration();
config.AddApiKey("authorization", projectScopedToken);
DenyListApi denyListApi = new DenyListApi(config);
List<string> userGroupNames = ["<GROUP_NAME>"];
GroupNamesInput input = new GroupNamesInput(userGroupNames);
denyListApi.UnblockGroups(input);
UnblockUsers
Unblock by User ID (DID).
Parameters
BlockedUsersInput [Object]
List of User IDs (DIDs) to block. See more here.
Example
using AffinidiTdk.LoginConfigurationClient.Api;
using AffinidiTdk.LoginConfigurationClient.Client;
using AffinidiTdk.LoginConfigurationClient.Model;
Configuration config = new Configuration();
config.AddApiKey("authorization", projectScopedToken);
DenyListApi denyListApi = new DenyListApi(config);
List<string> userDidList = ["did:key..."];
BlockedUsersInput input = new BlockedUsersInput(userIds: userDidList);
denyListApi.UnblockUsers(input);
AllowList API
Used to allow groups and users to grant access on services like Affinidi Login when users are authenticating.
AllowGroups
Allows users by group.
Parameters
GroupNamesInput [Object]
List of groups to allow. See more here.
Example
using AffinidiTdk.LoginConfigurationClient.Api;
using AffinidiTdk.LoginConfigurationClient.Client;
using AffinidiTdk.LoginConfigurationClient.Model;
Configuration config = new Configuration();
config.AddApiKey("authorization", projectScopedToken);
AllowListApi allowListApi = new AllowListApi(config);
List<string> groupNames = ["<GROUP-NAME>"];
GroupNamesInput input = new GroupNamesInput(groupNames);
allowListApi.AllowGroups(input);
DisallowGroups
Disallow access to users by group.
Parameters
GroupNamesInput [Object]
List of groups to disallow. See more here.
Example
using AffinidiTdk.LoginConfigurationClient.Api;
using AffinidiTdk.LoginConfigurationClient.Client;
using AffinidiTdk.LoginConfigurationClient.Model;
Configuration config = new Configuration();
config.AddApiKey("authorization", projectScopedToken);
AllowListApi allowListApi = new AllowListApi(config);
List<string> groupNames = ["<GROUP_NAME>"];
GroupNamesInput input = new groupNamesInput(groupNames);
allowListApi.DisallowGroups(input);
ListAllowedGroups
Get list of allowed groups.
Parameters
pageToken [String]
Used for pagination.
Example
using AffinidiTdk.LoginConfigurationClient.Api;
using AffinidiTdk.LoginConfigurationClient.Client;
using AffinidiTdk.LoginConfigurationClient.Model;
Configuration config = new Configuration();
config.AddApiKey("authorization", projectScopedToken);
AllowListApi allowListApi = new AllowListApi(config);
GroupNames result = allowListApi.ListAllowedGroups();
Glad to hear it! Please tell us how we can improve more.
Sorry to hear that. Please tell us how we can improve.
Thank you for sharing your feedback so we can improve your experience.