Rebranding Sisense Mobile

Applicable to Sisense on Linux and Microsoft Windows

Sisense enables you to provide your users with a fully white-labeled version of Sisense Mobile that matches your brand's look and feel.

The following objects can be rebranded:

Rebranding Sisense Mobile is a premium Sisense offering. Contact your Sisense representative.

Sisense Mobile Rebranding Process

Once you have purchased a rebranded version of Sisense Mobile, download and complete this checklist, which details all the information and resources you must provide to Sisense.

Examples of resources are:

A detailed description of each required resource and field is included in the checklist.

Important: Zip these resource files together, and send the zipped file and your completed checklist to [email protected], with your Sisense representative copied on the email.

Sisense will create a rebranded mobile app and provide you with a version to try out. The white-labeled mobile app will be fully tested by Sisense QA, but Sisense recommends that you test it for yourself before uploading it to the app stores.

Sisense will provide instructions for signing the application and uploading it to the app stores.

Once Sisense validates that all resources are accounted for and are correct, the rebranding Sisense mobile process typically takes up to one month.

Publishing Your App

Note: It is your responsibility to publish your application. Use the information in this section to help you do so.

Before Sisense provides you with your rebranded mobile app, Sisense signs the app for you. Both the Google Play Store and the Apple App Store require that all apps are digitally signed with a certificate. Therefore, you must provide Sisense with the relevant certificates as described below. Sisense then returns the signed app to you and you can publish the app in the Google Play Store (Android) or in the Apple App Store (iOS).

For instructions on how to publish, see Resources for Publishing Your Application.

Generating Signing Certificates

Android

Signing Your App

Notes

iOS

  1. Go to https://developer.apple.com and create an identifier (App ID) for the new app.
  2. Under App Services, select Push Notifications.
  3. If you don't have an iOS production certificate, create one. See the instructions, below.
  4. Download the certificate to the Mac that has your private key, and add it to the key chain (double click).
  5. Open Keychain Access on your Mac, and under My Certificates locate the iPhone Distribution Certificate you have created for the app.
  6. Select File > Export Item. Make sure the file format is p12.
  7. In developer.apple.com, create a Distribution Provisioning Profile for your app, using the same certificate you created above.
  8. Download the certificate to your Mac.
  9. Double click the certificate. This will start the process to install it.

For more information, see Code Signing.

Creating a Certificate for the Apple App Store

You need to create a p12 certificate to publish an application on the Apple App Store. There are three main steps in this procedure:

  1. Create a .certSigningRequest (CSR) file
  2. Create the .cer file
  3. Install the .cer file and generate a .p12 certificate

These steps are detailed below.

Note: Before performing this procedure, make sure you have registered in the iOS Developer Program.

1. Create a .certSigningRequest (CSR) File

  1. From Utilities or the Launchpad, search for and open Keychain Access.


  2. From the Keychain Access toolbar, select Keychain Access > Preferences.

  3. Click the Certificates tab.

  4. Set both Online Certificate Status Protocol and Certificate Revocation List to Off.

  5. Close the window.

  6. From the toolbar, open Keychain Access > Certificate Assistant > Request a Certificate From a Certificate Authority.

  7. Enter the email address and common name that you used to register in the iOS Developer Program.

  8. Leave the CA Email field empty and select Saved to disk and Let me specify key pair information.

  9. Click Continue.

  10. Select a filename and destination on your local computer.

  11. Click Save.

  12. Set the Key Size value to 2048 bits.

  13. Set Algorithm to RSA.

  14. Click Continue.
    This creates and saves your certSigningRequest file (CSR) to your local computer. A public and private key is also installed in Keychain Access with the Common Name entered.

2. Create a .cer File in Your iOS Developer Account

  1. Go to https://developer.apple.com/account/resources/certificates/list and sign in to your Apple Developer Account.
  2. Click Certificates, Identifiers & Profiles.
  3. Click Add + at the top-right of the main panel.
  4. Select Apple Distribution
  5. Click Continue.
  6. Click Choose File and locate the CSR file on your local machine that you created in the first stage of this procedure.

  7. Click Generate.

  8. Click Download to download the file.

  9. Click Provisioning Profiles.

  10. Under Distribution, select App Store and click Continue.

  11. In the dropdown, select the relevant app ID, and click Continue.
    If multiple certificates are shown, make sure to select the correct one.

  12. Check that the expiration date matches. This is important in case you want to export *.p12 Distribution certificates from Keychain.


  13. Click Download to save your provision file.

3. Install .cer and Generate a .p12 Certificate

  1. Locate the .cer file you downloaded in the previous stage and double-click it.
  2. Set the Login dropdown to login and click Add.
  3. Open Keychain Access and locate the profile created in the first stage of this procedure.
    Important: Make sure that the certificate is “trusted” and “valid”. If not, you won't be able to export it in p12 format.
  4. Expand the private key profile to display the certificate you added.

  5. Select the private key and the certificate. Do not select the public key.

  6. Right-click the selection and select Export 2 items.

  7. Make sure that the file format is .p12 and enter a filename and destination on your local computer.

  8. Click Save.

  9. Set a password and click OK.

4. Upload the .p12 Certificate to FireBase

  1. Navigate to https://console.firebase.google.com/u/0/project.
  2. Click Add a project.
  3. Add the following details:

    1. Project name

    2. iOS bundle ID
      The same as you mentioned in the Sisense Mobile Checklist.

    3. App Store ID.
      You can find your App Store ID in your app’s URL. In the following example, the App Store ID is 123456789:
      https://itunes.apple.com/us/app/yourapp/id123456789

  4. Add your Android and/or iOS apps and check if all configurations are set correctly.

  5. When you have uploaded your Development APNs certificate and have configured all the settings, download the .plist file.

  6. To enable sending push notifications:

    1. Create an Auth Key or Certificate in the Apple Developer Member Center

    2. Navigate to https://developer.apple.com/account/resources/certificates/add.

    3. In the Certificates, Identifiers and Profiles page, click Certificates > Add.

      You can now use one certificate for both the sandbox and production environment.


    4. Install the .cer and export the .p12 with keystore in the same way as was done when signing the certificate.

  7. Navigate to https://console.firebase.google.com/u/0/project/YOUR_PROJECT_NAME.

  8. Click Settings > Cloud Messaging > iOS App Configuration > APNs Certificate.

  9. In the Upload your Development APNs certificate section, upload your .p12 file.

5. Create the Authentication Key (Optional)

Generate an authentication key for an App ID enabled for push notifications. If you have an existing key, you can use that key instead of generating a new one.

  1. In your developer account, navigate to Certificates, Identifiers & Profiles.
  2. In the Keys section, select All.
  3. In the upper-right corner, click Add +.

  4. Enter APNs Auth Key description.

  5. Under Key Services, select the APNs checkbox and click Continue.

  6. Click Confirm and then Download.
    Important: Save your key in a secure place. This is a one-time download and the key can't be retrieved later.

  7. To verify that your APNs authentication key is set up properly and is accepted by APNs, send a test push notification.

Sisense Mobile Upgrades

Sisense regularly releases updates for Sisense Mobile. Sisense will periodically (about once a quarter) notify you when an upgraded rebranded version is available, and you can choose whether to upload the app to your store or not.

To apply the upgrade, you might need to regenerate certificates, based on their expiration date.

Sisense performs a full QA cycle on all upgrades, but recommends that you test every version of your application before publishing.

For instructions on how to publish, see Resources for Publishing Your Application.

Contact us at [email protected] for any technical questions related to this process.

Resources for Publishing Your Application

Use these resources to help you learn how to publish and republish your application:

Android *.apk

IOS *.ipa

Loading the *.ipa file without TestFlight