Difference between revisions of "Integration Key Management"
From SmartWiki
Ann Vincent (talk | contribs) m |
|||
| (20 intermediate revisions by 5 users not shown) | |||
| Line 1: | Line 1: | ||
==Overview== | ==Overview== | ||
| − | SmartSimple allows for the ability to store | + | SmartSimple allows for the ability to store the authentication credentials for various integration end points and external services. The purpose of this is to provide a single point of configuration for integration credentials that can then be referenced throughout the system. |
| − | Features include native integration | + | Features include native integration with services such as Salesforce, and Adobe Acrobat Sign, as well any custom end point. |
==Configuring Integration Keys== | ==Configuring Integration Keys== | ||
You need to have [[Global User Administrator]] permissions in order to access Integration key functions. | You need to have [[Global User Administrator]] permissions in order to access Integration key functions. | ||
| − | # | + | # Within SmartSimple, access the '''Global Settings''' page. |
# Click on the '''Integrations''' tab and under '''Services Settings''', click on '''Integration Key Management''' link. | # Click on the '''Integrations''' tab and under '''Services Settings''', click on '''Integration Key Management''' link. | ||
# This page will list all current integration keys configured for this instance of SmartSimple. | # This page will list all current integration keys configured for this instance of SmartSimple. | ||
| + | # Create a new Integration Key by clicking the''' +''' button on the top left. | ||
| + | # Select a Key Type, fill out the authentication details and click '''Save''' once complete. | ||
| − | + | [[File:Integration Key-1.PNG|600px]] | |
| − | [[File:Integration Key-1.PNG| | ||
| − | |||
| − | |||
===Function Settings=== | ===Function Settings=== | ||
Each new integration key has the following fields below. | Each new integration key has the following fields below. | ||
| − | * '''Key | + | {| class="contenttable" style="height: 190px;" width="557" |
| + | |- | ||
| + | || | ||
| + | * '''Key Types''' | ||
** Custom | ** Custom | ||
| − | ** Adobe Sign | + | ** [[Adobe Acrobat Sign]] |
| − | ** Salesforce | + | ** [[Salesforce integration|Salesforce]] |
| − | * ''' | + | ** Zoom |
| − | * ''' | + | ** [[DocuSign]] |
| − | * ''' | + | ** OAuth2 |
| + | ** [[SignEasy]] | ||
| + | ** [[ORCID Integration|ORCID]] | ||
| + | ** General - File Transfer | ||
| + | ** PGP Key | ||
| + | ** SCOPUS | ||
| + | ** SignEasy | ||
| + | ** KeyStore | ||
| + | ** NCBI | ||
| + | ** Companies House | ||
| + | ** Configuration Exchange | ||
| + | ** Web of Science (WOS) | ||
| + | |||
| + | || | ||
| + | [[Image: KeyTypes.png|330px]] | ||
| + | |||
| + | |} | ||
| + | * '''Name ''' - Unique name description for this integration key. | ||
| + | * '''Security Token ''' - Access token or integration key from the external service. | ||
| + | * '''Authentication URL ''' - end point of external service. | ||
* '''Synchronization Direction ''' | * '''Synchronization Direction ''' | ||
** From SmartSimple to External Service | ** From SmartSimple to External Service | ||
| Line 33: | Line 54: | ||
* '''Password ''' - Password of API account | * '''Password ''' - Password of API account | ||
| − | + | In the case of [[Adobe Acrobat Sign]] integration, this requires input of OAuth security token and Application ID which is available by signing into your Adobe ID account at [https://accounts.adobe.com https://accounts.adobe.com]. See the [[Adobe Acrobat Sign|Adobe Acrobat Sign article]] on this wiki for how to configure Adobe Acrobat Sign e-signature documents. | |
| − | In the case of [[Adobe Sign]] integration, this requires input of OAuth security token and Application ID which is available by signing into your Adobe ID account at [https://accounts.adobe.com | ||
==Retrieving Integration Keys== | ==Retrieving Integration Keys== | ||
| − | Integration keys can be retrieved from the Variable Processor via the following syntax. The ssGet variables will only get replaced when the | + | Integration keys can be retrieved from the Variable Processor via the following syntax. The ssGet variables will only get replaced when the API call is made and will not resolve directly on the source of a page. This prevents exposing the credentials to the end user. |
| − | + | @ssGet(APIKEY,''keyname'',''attribute'')@ | |
| − | |||
| − | + | An example use of this would be using the built in service call function to make a RESTful API call | |
| − | |||
| − | + | <pre>//service call syntax: | |
| − | fields - contain all the parameters you may need (required is "svc=restful") | + | //exservice_call(syncflag, callbackfunc, fields, URL) |
| + | //URL - the URL to post the call to. | ||
| + | //fields - contain all the parameters you may need (required is "svc=restful"), delimited by ';;'. | ||
| − | exservice_call(false,"","svc=restful;;username=@ssGet(APIKEY, | + | //given an Integration Key named 'myapi' |
| + | exservice_call(false, "", "svc=restful;;companyid=xxx;;alias=xxx;;username=@ssGet(APIKEY,myapi,username)@;;password=@ssGet(APIKEY,myapi,password)@;;apitoken=xxx;;reportid=xxx", "https://smart.smartsimple.com.com/API/1/report/") | ||
</pre> | </pre> | ||
[[Category:Integration]] [[Category:System Integration]] | [[Category:Integration]] [[Category:System Integration]] | ||
Latest revision as of 13:51, 13 July 2023
Contents
Overview
SmartSimple allows for the ability to store the authentication credentials for various integration end points and external services. The purpose of this is to provide a single point of configuration for integration credentials that can then be referenced throughout the system.
Features include native integration with services such as Salesforce, and Adobe Acrobat Sign, as well any custom end point.
Configuring Integration Keys
You need to have Global User Administrator permissions in order to access Integration key functions.
- Within SmartSimple, access the Global Settings page.
- Click on the Integrations tab and under Services Settings, click on Integration Key Management link.
- This page will list all current integration keys configured for this instance of SmartSimple.
- Create a new Integration Key by clicking the + button on the top left.
- Select a Key Type, fill out the authentication details and click Save once complete.
Function Settings
Each new integration key has the following fields below.
|
|
- Name - Unique name description for this integration key.
- Security Token - Access token or integration key from the external service.
- Authentication URL - end point of external service.
- Synchronization Direction
- From SmartSimple to External Service
- From External Service to SmartSimple
- Bidirectional
- Username - Username of API account
- Password - Password of API account
In the case of Adobe Acrobat Sign integration, this requires input of OAuth security token and Application ID which is available by signing into your Adobe ID account at https://accounts.adobe.com. See the Adobe Acrobat Sign article on this wiki for how to configure Adobe Acrobat Sign e-signature documents.
Retrieving Integration Keys
Integration keys can be retrieved from the Variable Processor via the following syntax. The ssGet variables will only get replaced when the API call is made and will not resolve directly on the source of a page. This prevents exposing the credentials to the end user.
@ssGet(APIKEY,keyname,attribute)@
An example use of this would be using the built in service call function to make a RESTful API call
//service call syntax: //exservice_call(syncflag, callbackfunc, fields, URL) //URL - the URL to post the call to. //fields - contain all the parameters you may need (required is "svc=restful"), delimited by ';;'. //given an Integration Key named 'myapi' exservice_call(false, "", "svc=restful;;companyid=xxx;;alias=xxx;;username=@ssGet(APIKEY,myapi,username)@;;password=@ssGet(APIKEY,myapi,password)@;;apitoken=xxx;;reportid=xxx", "https://smart.smartsimple.com.com/API/1/report/")
