Existing Services
Services can be configured from a pre-defined list of available options. Each type of service requires different configuration settings.
- BLink Url shorten service
- Sengrid email service
- HungerBox service
- Office 365 domain wide authority service
- Razor pay service
- Rabbit MQ service
- 2Factor SMS service
- Open weather service
- Google domain wide authority service
- Internal calendar service
- Cowrks calendar service
- BulkSMS service
- Ldap service
- SMTP service
- SAP success factor service
- SAML-2 service
- Darwinbox service
- SMS country service
BLink Url Shorten Service
This is a short URL service which is used to shorten the URL to reduce the number of characters, making them easier to share, particularly useful for SMS messaging.
To configure this service:
- In the Service Type field, select Blink URL Shorten Service.
- Enter the required field information:
Field
Description BLink Domain*
Enter the domain of shortened URL. For example, dev.lshort.co/XYZ. This will point to the actual URL https://dev.bluecoiniot.com/visitorrequest.hmlt?code=XYZ BLink Email*
Enter the authentication ID to connect with BLink Service. BLink Refresh Token*
Enter the authentication token to connect with BLink Service. BLink Instance* Enter the instance of BLink Service to be used. Active
Select this checkbox to activate the service. - Click Save Service.
- To add another service, click Add More Services or to back to the previous page, click Back.
Sengrid Email Service
This service is used to connect with SendGrid’s email gateway for email communication. To configure this service:
- In the Service Type field, select Sengrid Email Service.
- Enter the required field information:
Field
Description Email Auth Key* Enter the authentication key to connect with SendGrid service. Sender Email Id Enter a custom sender email ID that is displayed in the email received by the end user.
Note: By default, this is noreply@bluecoiniot.com.
Sender Display Name Enter a custom sender name that is displayed in the email received by the end user. Use Alias Select this checkbox to use the recipient’s email alias along with their primary email ID while sending the email. Active
Select this checkbox to activate the service. - Click Save Service.
- To add another service, click Add More Services or to back to the previous page, click Back.
HungerBox Service
This service is used for in-app integration with the HungerBox food ordering system.
- In the Service Type field, select HungerBox Service.
- Enter the required field information:
Field
Description HungerBox Name*
Enter the name of the client as provided by the Hungerbox team. HungerBox Host*
Enter the Hostname for the client environment as provided by the Hungerbox team. HungerBox Client ID*
Enter the Authentication ID for the client environment as provided by the Hungerbox team. HungerBox Client Secret*
Enter the Authentication Key for the client environment as provided by the Hungerbox team. HungerBox Company Code*
Enter the Company code of the client as provided by the Hungerbox team. HungerBox Location Identifier*
Enter the Location identifier of the client as provided by the Hungerbox team. Active
Select this checkbox to activate the service. - Click Save Service.
- To add another service, click Add More Services or to back to the previous page, click Back.
Office 365 Domain Wide Authority Service
This is to set up integration with the Office 365 system. It can be used to enable Single Sign On (SSO) with Outlook, Meeting room calendar integration, and User database auto synchronization.
Note: For information on how to set up Office 365 integration, click here.
- In the Service Type field, select Office 365 Domain Wide Authority Service.
- Enter the required field information:
Field
Description App Id*
Enter the application ID copied from the Azure portal. App Password*
Enter the secret key copied from the Azure portal to access the service account. Auth End Point*
Enter the authentication URL for the client’s Office 365 tenant. For example, https://login.microsoftonline.com/<tenant_id>/oauth2/v2.0/authorize Redirect URL*
Enter the application URL to redirect the user after SSO. For example, https://dev.bluecoiniot.com Scopes*
Enter the basic access for users using the SSO option. For example, offline_access User.Read User Sync Filter*
Enter the name filter used at the time of syncing the active directory users to the Apptimus system. For example, if the admin wants to restrict the syncing to only users whose country is marked as India. App Tenant*
Enter the Office 365 Tenant ID of the client. Enable Outlook Calendar Push Event*
Select this checkbox to enable push notifications to be sent on the Apptimus app for any change in calendar events for tracked meeting rooms. Outlook Tenant Based Authentication*
Select this checkbox to enable authentication if SSO is via tenant specific verification URL. Calendar Access Restriction Select the required option to make the calendar available for: All mailboxes (Default)
ORSpecific meeting room mailboxes (Meeting room only)
Active
Select this checkbox to activate the service. - Click Save Service.
- To add another service, click Add More Services or to back to the previous page, click Back.
Note: For information on how to restrict application level access to specific mailboxes, click here.
Razor Pay Service
This is to configure RazorPay payment gateway for accepting online payment from the end user.
- In the Service Type field, select Razor Pay Service.
- Enter the required field information:
Field
Description Key ID*
Enter the authentication key to validate the Bluecoin payment account with RazorPay. Active
Select this checkbox to activate the service. Ignore Customer
Select this checkbox to prevent Razor Pay from saving the end user’s payment mode details for quick future checkouts. - Click Save Service.
- To add another service, click Add More Services or to back to the previous page, click Back.
- To change the secret key, click Change Secret Key.
- In the Change Secret Key pop-up window, enter the Secret Key, Confirm Secret Key and then click Done.
- To save the updated secret key, click Save Service.
Rabbit MQ Service
This is the messaging service cluster used for communication between internal application services and between the Apptimus application and other field applications provided by Bluecoin.
- In the Service Type field, select RabbitMQ Service.
- Enter the required field information:
Field
Description Rabbit Nodes*
Enter the RabbitMQ server endpoints in a comma-separated by IP: Port format. For example, 192.168.1.100:5671,192.168.1.101:5671 Rabbit User Name*
Enter the authentication username to connect to the RabbitMQ cluster. Rabbit Key Pass*
Enter the authentication password to connect to the RabbitMQ cluster. Active Rabbit SSL
Select this checkbox if communication is SSL enabled. Rabbit Keystore File
Upload the Rabbit Keystore file to establish connection with RabbitMQ cluster. Active
Select this checkbox to activate the service. - Click Save Service.
- To add another service, click Add More Services or to back to the previous page, click Back.
2Factor SMS Service
This service is to configure the SMS gateway provided by 2Factor.
- In the Service Type field, select 2Factor SMS Service.
- Enter the required field information:
Field
Description SMS Auth Key*
Enter the authentication key to connect with 2Factor’s account. Active
Select this checkbox to activate the service. - Click Save Service.
- To add another service, click Add More Services or to back to the previous page, click Back.
Open Weather Service
This service is to configure the live weather forecast service for the given GPS coordinates of each campus.
- In the Service Type field, select Open Weather Service.
- Enter the required field information:
Field
Description Weather Auth Key*
Enter the authentication key to connect with the Open Weather account. Active
Select this checkbox to activate the service. - Click Save Service.
- To add another service, click Add More Services or to back to the previous page, click Back.
Google Domain Wide Authority Service
- In the Service Type field, select Google Domain Wide Authority Service.
- Enter the required field information:
Field
Description App Id*
Enter the Client ID of registered application to allow single sign on. App Password*
Enter the client Secret of registered application to allow single sign on. Auth End Point*
Enter the Endpoint URL user is redirected to while SSO. Redirect URL*
Enter the Endpoint URL where the user is directed after SSO. In most cases this is the cloud manager domain. Scopes*
Enter the permission requested to the end user during SSO like read access to user profile. Service Account Id*
Enter the Service Account Email ID created during configuration. Service Account User*
Enter the email address of the user who has the delegated permission to manage events for meeting room calendars. Service Account Key File*
Enter the Service account verification key file used for integration. Enable Google Calendar Push Event
Select this checkbox to allow change event notifications to be sent for Google calendars. Active
Select this checkbox to activate the service. - Click Save Service.
- To add another service, click Add More Services or to back to the previous page, click Back.
Internal Calendar Service
This is an internal meeting room calendar system when no other system like Offic365 or Google is available. This does not integrate with any third party calendar system and its capabilities are limited to meeting room event management.
- In the Service Type field, select Internal Calendar Service.
- Enter the required field information:
Field
Description Active
Select this checkbox to activate the service. - Click Save Service.
- To add another service, click Add More Services or to back to the previous page, click Back.
Cowrks Calendar Service
This service is used for integrating with CoWrks calendar system to access meeting room events.
- In the Service Type field, select Cowrks Calendar Service.
- Enter the required field information:
Field
Description Host*
Enter the Host URL of CoWrks calendar system. API Token*
Enter the Authentication key to connect with the CoWrks calendar system. Active
Select this checkbox to activate the service. - Click Save Service.
- To add another service, click Add More Services or to back to the previous page, click Back.
BulkSMS Service
This is an SMS service provided by https://www.bulksms.com/.
- In the Service Type field, select BulkSMS Service.
- Enter the required field information:
Field
Description Bulk Auth Key*
Enter the authentication key to connect with BulkSMS service. SMS Sender ID
Enter an optional sender ID. Active
Select this checkbox to activate the service. - Click Save Service.
- To add another service, click Add More Services or to back to the previous page, click Back.
LDAP Service
This service is used to connect with the LDAP system for Single Sign On or automated user management.
- In the Service Type field, select Ldap Service.
- Enter the required field information:
Field
Description LDAP Host*
Enter the LDAP system IP/Domain. LDAP Port*
Enter the LDAP system port. LDAP Username*
Enter the LDAP username to connect to the service. LDAP Search Name*
Enter the name of the context or object to search. LDAP Search Filter*
Enter the filter expression to use for the search. Active
Select this checkbox to activate the service. - Click Save Service.
- To add another service, click Add More Services or to back to the previous page, click Back.
- To change the password to connect to the service, click Change Password.
- In the Change Password pop-up window, enter the Password, Confirm Password and then click Done.
- To save the updated password, click Save Service.
SMTP Service
This service is used for running the email service using the SMTP server.
- In the Service Type field, select SMTP Service.
- Enter the required field information:
Field
Description SMTP Email*
Enter the username to connect with the SMTP server. SMTP Port*
Enter the SMTP Server port to connect with the SMTP server. SMTP Host*
Enter the SMTP Server host to connect with the SMTP server. SMTP SSL
Select this checkbox if the connection to the server is SSL enabled. Use Alias
Select this checkbox to use email alias, if any, at the time of sending emails. Active
Select this checkbox to activate the service. - Click Save Service.
- To add another service, click Add More Services or to back to the previous page, click Back.
- To change the password to connect with the SMTP server, click Change Password.
- In the Change Password pop-up window, enter the Password, Confirm Password and then click Done.
- To save the updated password, click Save Service.
SAP Success Factor Service
This service is for integration with SAP success factor HRMS software for automated user management.
- In the Service Type field, select SAP Success Factor Service.
- Enter the required field information:
Field
Description Host*
Enter the SAP Server host to connect with the server. Client ID*
Enter the Client ID for verification purposes. User ID*
Enter the User ID for verification purposes. Token URL*
Enter the URL required to create a token while connecting with the server. Company ID*
Enter the Company ID for verification purposes. Grant Type*
Enter the grant type required to get user data while connecting with the server. Active
Select this checkbox to activate the service. - Click Save Service.
- To add another service, click Add More Services or to back to the previous page, click Back.
- To change the authentication key, click Change Private Key.
- In the Change Private Key pop-up window, enter the Private Key and then click Done.
- To save the updated private key, click Save Service.
SAML-2 Service
This service is used to enable SSO via the SAML 2.0 based system.
- In the Service Type field, select SAML-2 Service.
- Enter the required field information:
Field
Description Entity ID* Enter the globally unique name for a SAML entity. This is part of the metadata file received after SAML entity setup. Signon URL*
Enter the Url where the user is redirected for Sign In. This is part of the metadata file received after SAML entity setup. Request Payload
Enter the XML request payload when the user is redirected for Sign In. Response Inflate
Select this checkbox to use inflater to decode the response after Sign In. Response Inflate No Wrap
Select this checkbox to use inflater with wrap to decode the response after Sign In. Active
Select this checkbox to activate the service. - Click Save Service.
- To add another service, click Add More Services or to back to the previous page, click Back.
- To change the certificate key to verify the sign-in response (part of the metadata file received after SAML entity setup), click Change Certificate.
- In the Change Certificate pop-up window, add the Certificate and click Done.
- To upload the request payload, click Upload Request Payload, upload the payload file, and then click Upload.
- To delete the uploaded request payload, click Clear Request Payload.
Darwinbox Service
This service is a type of HRMS service and allows you to sync employee data for automated user onboarding.
- In the Service Type field, select Darwinbox Service.
- Enter the required field information:
Field
Description Host* Enter the base URL or domain of your Darwinbox instance.
Client ID*
Enter the unique identifier for your application or integration, assigned by Darwinbox when you register for API access. It is used to identify “who” is making the API request.
Client Secret*
Enter the confidential string (password) associated with your client ID for securely authenticating your application when requesting tokens or making certain API requests.
Code*
Enter the authorization code provided by Darwinbox.
Dataset*
Enter the dataset provided by Darwinbox.
Active
Select this checkbox to activate the service. - Click Save Service.
- To add another service, click Add More Services or to back to the previous page, click Back.
SMS Country Service
This service is to configure the SMS gateway provided by SMS Country Networks.
- In the Service Type field, select SMS Country Service.
- Enter the required field information:
Field
Description API URL*
Enter the URL provided by SMS Country to connect to the SMS Country’s services.
Sender ID*
Enter the registered name or code (approved by SMS Country) that is displayed as the sender when recipients receive your SMS.
Auth Key*
Enter the unique authentication key provided by SMS Country to validate and secure your API requests.
Active
Select this checkbox to activate the service. - Click Save Service.
- To add another service, click Add More Services or to back to the previous page, click Back.
