Microapps

Integrate Covid-19 Self Certify

Deploy the Covid-19 Self Certify integration to submit your Covid-19 self-certification status using the self-certification response from Citrix Workspace.

We want your feedback! Please provide feedback for this integration template as you use it. For any issues, our team will also monitor our dedicated forum on a daily basis.

For comprehensive details about this microapp, see Use Covid Self Certify microapps.

Review prerequisites

The COVID Self-Certification Podio app pack is required for this integration. For more information, see Get and configure the Covid-Self Certify app in Citrix Podio.

After you set up this integration with Covid-19 Self Certify, you will need these artifacts to add the integration in Citrix Workspace Microapps:

  • Base URL: https://api.podio.com
  • Covid Self Certification App Id: Enter your Podio Workspace App ID. See Collect App ID and App token.
  • Covid Self Certification View Id: Enter your Podio Workspace App View ID. See Collect View ID.
  • Country Data App Id: Enter your Country Data App ID available in Covid-19 self-certification. See Collect Country Data App ID.
  • Authentication method: OAuth 2.0

    Note:

    We recommend that you always use OAuth 2.0 as your service authentication method where available. OAuth 2.0 ensures that your integration meets the maximum security compliance with your configured microapp.

  • Grant type flow: Authorization Code
  • Grant type value: authorization_code
  • Callback URL: https://{yourmicroappserverurl}.us.iws.cloud.com/admin/api/gwsc/auth/serverContext
  • Token authorization: Request body
  • Token content type: URL encoded form
  • Authorization URL: https://podio.com/oauth/authorize
  • Token URL: https://podio.com/oauth/token
  • Client ID: The client ID is the string representing client registration information unique to the authorization server.
  • Client secret: The client secret is a unique string issued when setting up the target application integration.
  • Refresh token URL: NA
  • Scope: NA
  • Relay state: NONE
  • Access token parameters: Enter the name and value parameters as per the instructions given below:
    1. app_id: Enter your Podio Workspace App ID. See Collect App ID and App token.
    2. app_token: Enter Podio Workspace App Token. See Collect App ID and App token.
    3. grant_type: app
  • Request rate limiting: 15 request per minute
  • Request timeout: 120

Create service account

The integration requires regular access to your Covid Self Certify instance, so we recommend creating a dedicated user account. This account must be an administrator or member of the Covid Self Certify Podio Workspace app.

To add multiple admin/members to the Covid Self Certify Podio Workspace, see Covid Self Certify Workspace.

Get and configure the Covid Self Certify app in Citrix Podio

The COVID Self-Certification app pack is required for this integraion. The app pack includes the Covid Self Certification app and the Country Data app. Install this app pack from the Podio App Market: COVID Self-Certification app pack.

To configure the app, follow these steps:

  1. Log in to your Citrix Podio instance: https://podio.com/.
  2. Create a Workspace with an appropriate name.
  3. Add the Country Data app into your workspace and insert the following four fields into the Country Data app:
    1. Region: Add a Text component named Region which stores the region name.
    2. Countries: Add a Text component named Countries which stores the countries or cities that you want to display to end users, regarding region.
    3. Guidelines: Add a Text component named Guidelines which stores the guidelines or conditions that end users need to follow.
    4. Image: Add a Link component named Image which stores any image that suits your region.
  4. Add the Covid Self Certify app into your workspace and insert the following six fields into the Covid Self Certify app:
    1. Name: Add a Text component named Name which stores the name of the employee/user.
    2. Email: Add a Email component named Email which stores the email of the employee/user.
    3. Condition: Add a Category component named Condition and insert two category options: Agree and Disagree.
    4. CreatedOn: Add a Date component named CreatedOn which stores the agreed/disagreed date and time value.
    5. Region: Add a Text component named Region which stores the region value selected by the user/employee.
    6. Country: Add a Text component named Country which stores the country value selected by the user/employee.

Configure the OAuth client app

  1. Log in to the Podio Developer site as Podio Workspace Application Admin: https://developers.podio.com.
  2. Select Generate Your API Key.
  3. Select Get an API key now and enter the Application name field and the Domain field as per the instructions given below.
    1. Application name: Enter your app name.
    2. Domain: Enter your Microapps instance URL for Full domain (without protocol) of your return URL. This section of the URL {yourmicroappserverurl} is composed of a tenant part, a region part, and an environment part: https://{tenantID}.{region(us/eu/ap-s)}.iws.cloud.com.
  4. Select Generate API key.
  5. Under Your API keys, copy and save the Client ID and Client Secret values for future reference.

For more information, see https://docs.citrix.com/en-us/citrix-microapps/set-up-template-integrations/integrate-podio.html#collect-client-id-and-client-secret.

Collect App ID and App token

Collect the App ID and App Token from Podio to authenticate as an app instead of a user. With App ID access, users can access only data of apps within the related Podio Workspace. You collect this ID from the Podio app for the Podio workspace. If you have multiple apps in a workspace, you can use any of the App IDs affiliated with the workspace.

Follow these steps:

  1. Log in to Podio, and navigate to your Podio app.
  2. Select the Tools icon next to the app name.
  3. Under App, select Developer.
  4. Copy and save the App ID and Token fields. You enter these values as Access token parameters when you set up the integration.

For more information, see https://docs.citrix.com/en-us/citrix-microapps/set-up-template-integrations/integrate-podio.html#collect-app-id-and-app-token.

Collect View ID

  1. Log in to Podio, and navigate to your Podio app.
  2. Mouse over the field specified above to see the view ID at the bottom-left of your browser. For covid-19 self-certify, place your cursor over Agreed/Disagreed and look for your View ID in the URL link.

For more information, see https://docs.citrix.com/en-us/citrix-microapps/set-up-template-integrations/integrate-podio.html#collect-view-id.

Collect Country Data App ID

  1. Log in to Podio, and navigate to your Podio app.
  2. Select the Tools icon next to the app name.
  3. Under Country Data App, select Developer.
  4. Copy and save the App ID and Token fields. You enter these values as Access token parameters when you set up the integration.

Add the integration to Citrix Workspace Microapps

Add the Covid Self Certify integration to Citrix Workspace Microapps to connect to your application. This delivers out-of-the-box microapps with pre-configured notifications and actions which are ready to use within your Workspace.

Follow these steps:

  1. From the Microapp Integrations page, select Add New Integration, and Add a new integration from Citrix-provided templates.
  2. Choose the Covid Self Certify tile.
  3. Enter an Integration name for the integration.
  4. Enter Connector parameters.
    • Enter the instance Base URL: https://api.podio.com
    • Enter your Podio App Id.
    • Enter your Podio Workspace App View Id.

    Covid config set up

  5. Under Service authentication, select OAuth 2.0 from the Authentication method menu and complete the authentication details. The authentication options are preselected. Ensure that these options are selected as you complete the process. Use the OAuth 2.0 security protocol to generate request/authorization tokens for delegated access. It is recommended that you always use OAuth 2.0 as your service authentication method where available. OAuth 2.0 ensures that your integration meets the maximum security compliance with your configured microapp.

    1. Select Authorization Code from the Grant type flow menu.
    2. Enter authorization_code in the Grant type values field.
    3. Enter https://{yourmicroappserverurl}.us.iws.cloud.com/admin/api/gwsc/auth/serverContext in the Callback URL field.
    4. Select Request body from the Token authorization menu.
    5. Select URL encoded form from the Token content type menu.
    6. Enter https://podio.com/oauth/authorize in the Authorization URL field.
    7. Confirm the Token URL field. This value is prefilled: https://podio.com/oauth/token.
    8. Enter your Client ID: The client ID is the string representing client registration information unique to the authorization server. You collect this and the Client secret when you generated an API key. See Configure the OAuth client app.
    9. Enter your Client secret: The client secret is a unique string issued when setting up the target application integration. You collect this and the Client ID when you generated an API key. See Configure the OAuth client app.
  6. Refresh token URL: NA
  7. Scope: NA
  8. Relay state: NONE

    Covid authentication set up

  9. Add the following Access token parameters. For more information, see Collect App ID and App token.
    1. app_id: Enter Podio Workspace App ID
    2. app_token: Enter Podio Workspace App Token
    3. grant_type: app

Covid token set up

  1. Under OAuth Authorization, select Authorize to log in with your service account. A pop-up appears with a Google login screen.
    1. Enter your Service Account username and your Service Account password and select Log in.
    2. Select Accept.
  2. Enter 15 requests per minute in the Request rate limiting field.
  3. Enter 120 in the Request timeout field.
  4. Select Save to proceed.

You are now ready to set and run your first data synchronization. For complete information about synchronization rules, synchronization that does not meet its schedule and veto rules, see Synchronize data.

Note:

We recommend triggering incremental synchronization once every hour and full synchronization two or three times a day.

For more details of API endpoints and table entities, see Covid-19 Self Certify connector specifications.

Use Covid Self Certify microapps

Existing application integrations come with out-of-the-box microapps. Start with these microapps and customize them for your needs.

Self Certify: Submit your daily covid-19 self-certification status response from Citrix Workspace.

Notification or Page Use-case workflows
Covid Self Certify - Agree: Item Change notification Get notified for all your agreed covid-19 self-certification response submission.
Covid Self Certify - Disagree: Item Change notification Get notified for all your disagreed covid-19 self-certification response submission.
New Self Certify - Agree: Item New notification Get notified for all your agreed covid-19 self-certification response submission (New user).
New Self Certify - Disagree: Item New notification Get notified for all your disagreed covid-19 self-certification response submission (New user).
Select Region: Item page Choose their working location.
Self Certification Guidelines page Submit the response for daily self-certification.
Self Certification Agreed: Item page View agreed response details for daily self-certification.
Self Certification Confirmed page View agreed response details for daily self-certification from their notification feed.
Self Certification Denied page View disagreed response details for daily self-certification.
Self Certification Disagree page View disagreed response details for daily self-certification from their notification feed.