Skip to main content
All CollectionsKnowledge Articles (Internal base)TT2/Admin Panel (Internal)
How to rebrand Service Providers TT2 domain
How to rebrand Service Providers TT2 domain
Albert Basiul avatar
Written by Albert Basiul
Updated over 7 months ago

Description:

This article will contain information on Trust Track web application rebranding.

Introduction

Ruptela provides TrustTrack as a service in a subscription-based manner. Therefore, to use it the end-users have to pay a monthly fee.

When selling this service to Service Providers, they are not usually the end-user, most commonly they act as Trust Track resellers, this is why we provide Trust Track as a white-label product in such cases.

A White-label product is a product that a company can brand as its own, but in our case, is a software that can be customized (rebranded) and look-alike as it was developed/owned by the company which is reselling this product.

Workflow

We need to know from the Service Provider what option of rebranding he will be choosing:

Customizable Item

Rebranding Option 1

Rebranding Option 2

Use *.fm-track.com subdomain

YES

NO

Use Client's own domain

NO

YES

TT2 main logo (login/reports)

YES

YES

TT2 internal logo (top left)

YES

YES

TT2 mobile logo

YES

YES

Custom notification email address

YES**

YES

Custom Sender Name in SMS*

YES

YES

* This will only work in countries where "Alphanumeric Sender ID" is available - Info
** Only if the SP has edit access to the domain DNS records
​
​

If Rebranding Option 1 is chosen, here are the steps to follow:

    1. Get from the service provider the following information:

      1. The subdomain name that they would like to use. For example, if the SP name is "abcde" and they would like to use their name as the subdomain, the subdomain would be:
        ​

        abcde.fm-track.com

      2. Logos in SVG format

        • Optimal size (in pixels) for each logo:

          • TT2 main logo: 240 x 60

          • TT2 internal logo: 20 x 20

          • TT2 mobile logo: 80 x 60

      3. Web Page title (information that will be shown in the browsers tab) - More info

      4. Web Page description (information will NOT be shown and only populate HTML meta content tag) - More Info

      5. Email to be displayed as the sender on notifications generated by TT2 (this will only work if the client has edit access to the DNS record of the email's domain)

      6. SMS sender name (11 character MAX)

      7. If he would like to leave or remove the "Powered by Ruptela" logo

    2. Go to https://track.ruptela.lt/administrator/serviceprovider/

    3. Press CTRL + F, type the SP name and click on Edit

    4. Scroll down to Trust Track 2 parameters

    5. Type the Web Page title on the Title textbox

    6. Type the Web Page description in the Description textbox

    7. Click on the Upload button next to Main and choose the TT2 main logo SVG file, then click on Open (file will be uploaded)

    8. Click on the Upload button next to Mini and choose the TT2 internal logo SVG file, then click on Open (file will be uploaded)

    9. Click on the Upload button next to Mobile and choose the TT2 mobile logo SVG file, then click on Open (file will be uploaded)

    10. Now over Domain Names, type in Trust Track 2 input text the subdomain chosen by the client, using the same example, the text that should be inputted is:

      abcde.fm-track.com

    11. Still over Domain Names, type in Reports input text the same subdomain with "reports-" appended to the beggining, using the example, the text that should be inputted is:
      ​

      reports-abcde.fm-track.com

    12. Still over Domain Names, type in Trust Track 1 input text, the same subdomain with "1" appended to the end of the subdomain name, using the example, the text that should be inputted is:
      ​

      abcde1.fm-track.com

    13. Now over Emails, type in Notifications input text, the email provided by the client.
      Note: this should only be replaced if the client has edit access to the DNS records of the email's domain, if he does not have this access, notification emails probably will not be delivered because they would be treated as spam

    14. Now over SMS, type in Sender Name input text, the email provided by the client.
      Note: There are some countries where the Sender Name does not work and it automatically gets replaced. More info

    15. If client requested, Untick the option "Disable 'Powered by Ruptela'"

    16. Tick the option Use all space for Mini logo, this will expands the corner mini logo to use all available space.

    17. Click on Save TrustTrack2 parameters button

Picture illustrating each step:
​

mceclip0.png

99 - User authentication only via token: ONLY ENABLE THIS OPTION IF YOU A SURE OF WHAT YOU ARE DOING

This is a special feature for service providers who do not want to use our authentication system (login and password) and have their own authentication systems.

This will be applied to all SP clients and web users. It means, that all SP clients will access Trust Track 2 system only via your system, they will not be able to login via Trust Track anymore. All SP web users password management will be disabled from Trust Track 2, and they will only be handled by SP own system.

To summarize, ALL web users under this SP will NOT be able to login to Trust Track 2 system directly with login and password.

Instead, the SP system will need to generate an access token via our API using their own API key and the user login. Then, using this token on a specific URL, access to Trust Track will be granted.

More info here

18. Open a Jira Task to add the client's domain to our Trust Track mobile app (iPhone and Android)

Example: https://ruptela.atlassian.net/browse/GUI-35421

    • Jira Project:Trust Track 2 (GUI)

    • Issue Type: Consultation

    • Issue Summary: Rebranding TrustTrack App: abcde.fm-track.com

    • Issue Description:
      ​      *None required*
      ​
      Note: After this task is executed it usually takes 2 hours for the Android app to be updated in the Playstore and usually takes 2 days for the iOS app to be updated in the AppleStore

If Rebranding Option 2 is chosen, here are the steps to follow:

      1. Get from the service provider the following information:

        1. The custom domain will be used to access the Trust Track web application.
          Example:
          ​

          abc.clientdomain.com

        2. Logos in SVG format

          • Optimal size (in pixels) for each logo:

            • TT2 main logo: 240 x 60

            • TT2 internal logo: 20 x 20

            • TT2 mobile logo: 80 x 60

        3. Web Page title (information that will be shown in the browsers tab) - More info

        4. Web Page description (information will NOT be shown and only populate HTML meta content tag) - More Info

        5. Email to be displayed as the sender on notifications generated by TT2 (this will only work if the client has edit access to the DNS record of the email's domain)

        6. SMS sender name ( 11 character MAX )

        7. If he would like to leave or remove the "Powered by Ruptela" logo

      2. Go to https://track.ruptela.lt/administrator/serviceprovider/

      3. Press CTRL + F, type the SP name and click on Edit

      4. Scroll down to Trust Track 2 parameters

      5. Type the Web Page title on the Title textbox

      6. Type the Web Page description in the Description textbox

      7. Click on the Upload button next to Main and choose the TT2 main logo SVG file, then click on Open (file will be uploaded)

      8. Click on the Upload button next to Mini and choose the TT2 internal logo SVG file, then click on Open (file will be uploaded)

      9. Click on the Upload button next to Mobile and choose the TT2 mobile logo SVG file, then click on Open (file will be uploaded)

      10. Now over Domain Names, type in Trust Track 2 input text the subdomain chosen by the client, using the same example, the text that should be inputted is:

        abc.clientdomain.com

      11. Still over Domain Names, type in Reports input text the same subdomain with "reports-" appended to the beggining, using the example, the text that should be inputted is:
        ​

        reports-abc.clientdomain.com

      12. Still over Domain Names, type in Trust Track 1 input text, the same subdomain with "1" appended to the end of the subdomain name, using the example, the text that should be inputted is:
        ​

        abc1.clientdomain.com

      13. Now over Emails, type in Notifications input text, the email provided by the client.
        Note: this should only be replaced if the client has edit access to the DNS records of the email's domain, if he does not have this access, notification emails probably will not be delivered because they would be treated as spam

      14. Now over SMS, type in Sender Name input text, the email provided by the client.
        Note: There are some countries where the Sender Name does not work and it automatically gets replaced. More info

      15. If the client requested, Untick the option "Disable 'Powered by Ruptela'"

      16. Tick the option Use all space for Mini logo, this will expands the corner mini logo to use all available space.

      17. Click on the Save TrustTrack2 parameters button

      18. Send this response to the client:
        Hi,
        We have begun to execute all the necessary changes internally and will provide you with feedback soon.
        Now we need you to update your domain DNS Record A with this IP address: 92.62.134.114, if you do not execute this task, you will not be able to access the Trust Track web application through your custom domain.

      19. Open a Jira Task to issue the SSL certificate for this new domain and automate its renewal.
        ​

        • Jira Project: SRE(IT)

        • Issue Type: Request

        • Issue Summary: Issue SSL certificate for SP rebranding, domain: abc.clientdomain.com

        • Issue Description:
          ​          Please, issue the SSL certificate for this SP domain that requested TT2 rebranding.
          Service Provider Name: ABC
          Service Provider ID: 123456
          Domain: abc.clientdomain.com

        • Issue TT Team: DevOps
          Note: No action is needed to be done after this task is executed.

      20. Open a Jira Task to issue the DKIM and SPF for the email's domain used to send notifications

        • Jira Project: SRE(IT)

        • Issue Type: Request

        • Issue Summary: Issue DKIM and SPF for SP rebranding, email: [email protected]

        • Issue Description:
          ​          Please, issue the DKIM and SPF for this SP domain that requested TT2 rebranding.
          Service Provider Name: ABC
          Service Provider ID: 123456
          Email: [email protected]
          Note: After this task is executed, you will need to provide the DKIM and SPF information for the Service provider and ask them to update the DNS record TXT accordingly. If the SP does not update this information, notification emails will go to SPAM or not even get delivered.

      21. Open a Jira Task to add the client's domain to our Trust Track mobile app (iPhone and Android)

        • Jira Project:Trust Track 2 (GUI)

        • Issue Type: Consultation

        • Issue Summary: Rebranding TrustTrack App: abc.clientdomain.com

        • Issue Description:
          ​          *None required*
          ​
          Note: After this task is executed it usually takes 2 hours for the Android app to be updated in the Playstore and usually takes 2 days for the iOS app to be updated in the AppleStore

      22. Open a Jira Task to enable Google Maps for this SP

        • Jira Project: Trust Track 2 (GUI)

        • Issue Type: Consultation

        • Issue Summary: Enable Google Maps for SP Rebranding

        • Issue Description:
          ​          Please, Google Maps for this SP rebranding.
          Service Provider ID: 123456
          Service Provider Name: abcde
          URL: abc.clientdomain.com

Picture illustrating each step:

mceclip1.png

99 - User authentication only via token: ONLY ENABLE THIS OPTION IF YOU A SURE OF WHAT YOU ARE DOING

This is a special feature for service providers who do not want to use our authentication system (login and password) and have their own authentication systems.

This will be applied to all SP clients and web users. It means, that all SP clients will access Trust Track 2 system only via your system, they will not be able to login via Trust Track anymore. All SP web users password management will be disabled from Trust Track 2, and they will only be handled by SP own system.

To summarize, ALL web users under this SP will NOT be able to login to Trust Track 2 system directly with login and password.

Instead, the SP system will need to generate an access token via our API using their own API key and the user login. Then, using this token on a specific URL, access to Trust Track will be granted.

More info here

Few examples of what can be customized with pictures:

  • TrustTrack 2 URL

    • Default: track2.ruptela.com (TT2 main domain)

    • Can be used through: whatever.fm-track.com (Customizable subdomain, owned by Ruptela)

    • Can be used through: www.clientdomain.com(Customizable domain owned by the Client)

  • TrustTrack 2 main logo (seen in login/reports)
    ​

    mceclip1.png

  • TrustTrack 2 square dots logo (seen in top left corner)
    ​

    mceclip2.png

  • TrustTrack 2 logo in mobile version
    ​

    mceclip3.png

  • Sender email address in email notifications
    ​

    mceclip4.png

  • Sender name in SMS notifications - Info
    ​

Note 1: Logos must be properly cropped (logo should touch the edges of the screen, see image) and over a transparent background.

blobid2.png

Note 2: Use an online converter like https://www.aconvert.com/image/tiff-to-svg/ to convert and resize existing files if the client is unable to provide a proper file. However, it is much better if you create the vector file from scratch instead of converting it from an existing image).

Related Articles
How to use the <User Roles>
How to move an object from one client to another (Internal)
How to activate/suspend Service Provider access to LCM
How to grant access to TT2 Admin Panel to clients
How to get Service Provider's TT2 objects information from ERP
Did this answer your question?