---
title: Configuring CITSmart Instance for Mobile Access
slug: en/configuring-citsmart-instance-for-mobile-access
description: Learn how to configure your server using the CITSmart Experience Mobile Application for iOS and Android platforms with this comprehensive document. Find step-by-step instructions on configuring web services, installing the GlobalSign Intermediate Certific
docTags: 
createdAt: 2021-10-26T23:50:08.000Z
---

This document is intended to <font color="#3b9f0f">**provide guidance for configuring the server**</font> by using <font color="#3b9f0f">**CITSmart** </font>**Experience Mobile Application** (iOS and Android platform).

## Before getting started

It is necessary:

- [x] To have the deploy <font color="#3b9f0f">**CITSmart** </font>**Web in version 7.2.2.0**  &#x20;or higher;
- [x] To configure the **parameters 257&#x20;**&#x61;nd **272&#x20;**&#x6D;ust be:

* **Values:** "**Y**" or "**N**" **Default:** "&#x4E;**"**;
* If the value of the **parameter&#x20;**&#x69;s "**Y**", only notifications of requests without  &#x20;a current controller can be shown;
* If the value of the **parameter&#x20;**&#x69;s "**N**", notifications of all the requests can  &#x20;be shown.

- [x] The **parameters 254** (system parametrization), **255, 256, 258, 267, 284, 285, 286,  &#x20;350** also must be configurated.

## Configuring web services

Configure <font color="#3b9f0f">**CITSmart** </font>**Web Services** to access the functionality of the&#x20;<font color="#3b9f0f">**CITSmart** </font>**Experience&#x20;**&#x61;pplication.

1. On <font color="#3b9f0f">**CITSmart** </font>**Experience&#x20;**&#x57;eb, access the **Web Services** feature for the mobile   &#x20;(`System > Settings > Mobile > Citsmart Mobile Web Service`);
2. Click on the "**Link Groups**" tab and link the activity executing group to the   &#x20;<font color="#3b9f0f">**CITSmart** </font>**Experience Web Services**.

:::hint{type="success"}
✅ <u>**Rule**</u>**:&#x20;**&#x41;t the time the group is selected, it will be linked to all <font color="#3b9f0f">**CITSmart**</font>**&#x20;Experience&#x20;Web Services** in an automated way.
:::

## Installing GlobalSign Intermediate Certificate

In order to recognize the intermediate certificate of the **GlobalSign&#x20;**(**Digital&#x20;Certification Issuer**), it must be installed. Follow the procedures below:

1. Access   &#x20;the following address: [https://support.globalsign.com/customer/portal/articles/1464460-domainssl-intermediate-certificates](https://support.globalsign.com/customer/portal/articles/1464460-domainssl-intermediate-certificates);
2. Download the first certificate, as shown in the figure below:

![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/ye8Itx8LWNR6I7YmZ1uhb_image.png "Figure 1 - GlobalSign Intermediate Certificate")

- ****<font color="#3b9f0f">**On mobile\:**</font> you will be asked to install the certificate, just enter the generic name (**suggestion: GlobalSign**) and click on forward.
- ****<font color="#3b9f0f">**On desktop\:**</font> right-click the downloaded certificate (as shown below), click on install certificate, and proceed to finish.

::Image[]{src="https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/mlKBfojF6wzlzpFrh2aGY_image.png" size="62" width="458" height="434" caption="Figure 2 - Certificate Installation on desktop" position="center" showCaption="true"}

3\. Once installed, simply change the application's address to&#x20;"[https://citsmart.centralit.com.br/citsmart](https://citsmart.centralit.com.br/citsmart)".

### Android and iOS App Installation

1. Go to Store (Play Store or App Store) to download the <font color="#3b9f0f">**CITSmart** </font>**Experience Mobile**   &#x20;application;
2. Search for <font color="#3b9f0f">**CITSmart** </font>**Experience&#x20;**&#x61;nd after the search, select the application;
3. Press the "**Install**" button to download the application.

### Creating Key for use and consumption of Google APIs

In order for the use and consumption of the Google APIs to be possible, a Key&#x20;API must be created. For this, the following steps must be followed:

:::hint{type="warning"}
⚠️ <u>**Attention**</u>**!&#x20;**

To perform these procedures, you must be logged in with a **Google account**. &#x20;
:::

1. Go to the Google Developer   &#x20;Console [https://console.developers.google.com](https://console.developers.google.com/);
2. Click "**Create Project**", as shown in the figure below:

![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/ENqxMpaSTTjGWoqi_89oF_image.png "Figure 3 - Google Developer Console")

3\. A window will appear, as shown in the figure below, to inform the data of&#x20;the new project;

::Image[]{src="https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/w1gqOgjP6BivnOzOfkhEO_image.png" size="70" width="512" height="273" caption="Figure 4 - Project Creation Screen" position="center" showCaption="true"}

4\. Enter the name of the project and click on the Create button to create the&#x20;project.

5\. After creating the project, click **APIs&#x20;**&#x61;nd **Services**. Create the API Key,&#x20;by clicking on `APIs and Services > Credentials > Create Credentials > API Key`, as&#x20;shown in the figure below:

![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/gC_5axaGXp8vmLDsrN02R_image.png "Figure 5 - API Key Creation Screen")

6\. Once this is done, the API key will be displayed:

::Image[]{src="https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/KQegwSGmUj_EPItAF8rEY_image.png" size="68" width="439" height="158" caption="Figure 6 - API Key Options Screen for creation" position="center" showCaption="true"}



7\. Choose the menu option that best suits you. For more information on which key&#x20;will answer you, go&#x20;to [https://developers.google.com/console/help/new/#generatingdevkeys](http://developers.google.com/console/help/new/#generatingdevkeys)

8\. After the keys are created, the APIs can already be consumed.

### APIs to be used in the solutions

Below is the Google APIs to consider in the solutions:

::Image[]{src="https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/5MbbOOSue5bMWXFJmeYgD_image.png" size="36" width="348" height="187" caption="Figure 7 - APIs" position="flex-start" showCaption="true"}

- ****<font color="#3b9f0f">**Directions API\:**</font> the Google Directions API is consumed through HTTP  &#x20;requests. This API calculates directions between two points informed, the  &#x20;source and the destination, having several other options.
  - For more information about using this API,    &#x20;access: [https://developers.google.com/maps/documentation/directions](https://developers.google.com/maps/documentation/directions).
- ****<font color="#3b9f0f">**Distance Matrix API\:**</font> the Google Distance Matrix API allows the retrieval  &#x20;of arrays of distances between two points, that is, returns approximate  &#x20;results as well. The difference for the Google Directions API is that the  &#x20;Distance Matrix does not return such detailed information as the steps to be  &#x20;performed.
  - For more information about using this API,
    access: [https://developers.google.com/maps/documentation/distancematrix](https://developers.google.com/maps/documentation/distancematrix).
- ****<font color="#3b9f0f">**Geocoding API\:**</font> the Google geocoding API is an API that helps you  &#x20;retrieve geographic positions by sending an extended address as an argument.  &#x20;The consumption of the API is done by HTTP and the results can be obtained  &#x20;in XML or JSON.
  - For more information about using this API,
    access: [https://developers.google.com/maps/documentation/geocoding](https://developers.google.com/maps/documentation/geocoding).
- ****<font color="#3b9f0f">**Statics Maps API\:**</font> the Google Static Maps API will be used in cases where  &#x20;interaction will not be required as a map, but only as a view. It is interesting to  &#x20;use since it is lighter since it is not necessary to download JS resource  &#x20;and images that will not be used.
  - For more information about using this API,
    access: [https://developers.google.com/maps/documentation/staticmaps](https://developers.google.com/maps/documentation/staticmaps).
- ****<font color="#3b9f0f">**Google Maps JavaScript API\:**</font> the use of the API is done through a JS API.
  For your use, simply link to JS on the page that will use the maps.
  - For more information about using this API,
    access: [https://developers.google.com/maps/documentation/javascript](https://developers.google.com/maps/documentation/javascript)

## Activating an API

To enable an API for use, proceed as described below:

1. After performing the steps described in the "**Creating key for use   &#x20;and consumption of Google APIs**" section;
2. Click on `APIs and Services > Enable APIs and Services`, as shown in the figure   &#x20;below:

![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/qMdil8s9Gkrh-fHllstg8_image.png "Figure 8 - Google APIs")

3\. The **API library** will be displayed. Select the API you want to enable (the&#x20;figure below represents an example of API) and click on the "**Activate API**" button&#x20;as indicated in the figure below:

![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/nrzBaXqKUJ-Sk1joe58bl_image.png "Figure 9 - Google APIs Activation")

4\. Once this is done, the API will be enabled for use.

