This is the Authress SDK used to integrate with the authorization as a service provider Authress at https://authress.io.
Then required the package:
For more details on common use cases using Authress checkout the Authress Knowledge Base.
Authorize using a user tokenrequire 'authress-sdk' # create an instance of the API class during service initialization # Replace the base_url with the custom Authress domain for your account # https://authress.io/app/#/settings?focus=domain AuthressSdk.configure do |config| config.base_url = 'https://login.company.com' end # on api route [route('/resources/<resourceId>')] def getResource(resourceId) # Get the user token and pass it to authress user_identity = AuthressSdk::AuthressClient.verify_token(request.headers.get('authorization')) # Check Authress to authorize the user user_id = user_identity.sub resource_uri = "resources/#{resourceId}" # String | The uri path of a resource to validate, must be URL encoded, uri segments are allowed, the resource must be a full path, and permissions are not inherited by sub-resources. permission = 'READ' # String | Permission to check, '*' and scoped permissions can also be checked here. begin #Check to see if a user has permissions to a resource. api_instance = AuthressSdk::UserPermissionsApi.new api_instance.authorize_user(user_id, resource_uri, permission) rescue AuthressSdk::ApiError => e # Will throw except if the user is not authorized to read the resource if (e.status === 404) { return { statusCode: 404 } } puts "Exception when calling UserPermissionsApi->authorize_user: #{e}" raise end # On success, continue with the route code to load resource and return it return { resource: {}, statusCode: 200 }Authorize with a service client
require 'authress-sdk' # create an instance of the API class during service initialization # Replace DOMAIN with the Authress domain for your account # Create a service client in the Authress management portal and past the access token here # This will generate a token automatically instead of passing the user token to the api AuthressSdk.configure do |config| config.base_url = 'https://login.company.com' client_access_key = 'eyJrZXlJ....' config.token_provider = AuthressSdk::ServiceClientTokenProvider.new(client_access_key) end # on api route [route('/resources/<resourceId>')] def getResource(resourceId) # Check Authress to authorize the user user_identity = AuthressSdk::AuthressClient.verify_token(request.headers.get('authorization')) # Check Authress to authorize the user user_id = user_identity.sub resource_uri = "resources/#{resourceId}" # String | The uri path of a resource to validate, must be URL encoded, uri segments are allowed, the resource must be a full path, and permissions are not inherited by sub-resources. permission = 'READ' # String | Permission to check, '*' and scoped permissions can also be checked here. begin # Check to see if a user has permissions to a resource. api_instance = AuthressSdk::UserPermissionsApi.new api_instance.authorize_user(user_id, resource_uri, permission) rescue AuthressSdk::ApiError => e # Will raise exception if the user is not authorized to read the resource if (e.status === 404) { return { statusCode: 404 } } puts "Exception when calling UserPermissionsApi->authorize_user: #{e}" raise end # On success, continue with the route code to load resource and return it return { resource: {}, statusCode: 200 }
When a user creates a resource in your application, we want to ensure that they get access own that resource.
You may receive User does not have sufficient access to grant permissions to resources as an error along with the status code 403. This means that the service client or user jwt does not have access to create the access record. If using a service client, go to the Authress portal and create a one time record which grants the service client Authress:Owner
to Resources/
so that it can manage access records for these types of resources.
require 'authress-sdk' begin # Create a new access record. user_identity = AuthressSdk::AuthressClient.verify_token(request.headers.get('authorization')) new_record = AuthressSdk::AccessRecord.new { name: "Access To New Resource #{NewResourceId}", users: [{ userId: user_identity.sub }], statements: [{ resources: [{ resourceUri: "Resources/#{NewResourceId}" }], # Owner by default gives full control over this new resource, including the ability to grant others access as well. roles: ['Authress:Owner'] }] } api_instance = AuthressSdk::AccessRecordsApi.new result = api_instance.create_record(new_record) puts result rescue AuthressSdk::ApiError => e puts "Exception when calling AccessRecordsApi->create_record: #{e}" raise end
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4