How to authenticate users on your iOS app?

How to authenticate users on your iOS app?

What is user authentication? 

We have enhanced the existing mechanism to provide a better, safer, and simpler authentication process. The improved JWT Authentication mechanism verifies the authenticity of your end users and permits them to use the help widget. To access the tickets they submitted, end-users of your app must have an identity to authenticate themselves as a user of the Zoho Desk portal. Zoho Desk makes this authentication possible via the JSON Web Token (JWT).

Zoho Desk supports two authentication modes: Anonymous and JWT.

Anonymous

In this type, end-users are considered guest users. They can only submit tickets, view posts in the User Community, and chat with a customer support agent. They cannot view the tickets they submitted or actively participate in the User Community.

JWT

In this type, end-users are considered authenticated users. In addition to the activities that guest users can perform, authenticated users can view the submitted tickets and actively participate in the User Community (with rights to perform actions such as following a topic, adding a topic, and commenting on existing posts).

What is JWT Authentication?

JWT (JSON Web Token) is a secure and efficient way of exchanging claims between two parties. It is a compact and URL-safe method of representing data that needs to be transferred. JWT is usually used for authentication and authorization purposes. The token is digitally signed, which ensures its authenticity and integrity. JWTs are widely used in modern web applications and APIs to transmit information securely between the client and server.

Learn about the enhanced JWT authentication mechanism.

The following code snippet authenticates users in the SDK. To access all methods related to user authentication, ensure that you include the following import statements.

Swift

  1. import ZohoDeskPortalAPIKit

Objective-C

  1. @import ZohoDeskPortalAPIKit;

JWT Token

The token is passed from your app. Kindly refer to the enhanced JWT authentication mechanism.

Swift

  1. if !ZohoDeskPortalSDK.isUserLoggedIn
    {
        ZohoDeskPortalSDK.login(withJWTToken: String)
        { (isSuccess: Bool) in
            // isSuccess shows whether the login attempt was successful
            // any errors will be logged
        }
    }else
    {
            // user logged in already
    }

Objective-C

  1. if (!ZohoDeskPortalSDK.isUserLoggedIn)
    {
        [ZohoDeskPortalSDK loginWithJWTToken:
        <#(NSString * _Nonnull)#> onCompletion:^(BOOL isSuccess)
        {
             // isSuccess shows whether the login attempt was successful
             // any errors will be logged
        }];
    }else
    {
             // user logged in already
    } ;
AlertZohoDeskPortalSDK.isUserLoggedIn is a boolean value that tells whether the user is logged in.

Logging out users from the SDK

To log a user out of the SDK, use the following method:

Swift

  1. ohoDeskPortalSDK.logout { (isSuccess: Bool ) in
        // isSuccess shows whether the logout attempt was successful
        // any errors will be logged
    }

Objective-C

  1. [ZohoDeskPortalSDK logoutOnCompletion:^(BOOL isSuccess) {
         // isSuccess shows whether the logout attempt was successful
         // any errors will be logged
    }];
Notes
After this method is triggered, the authenticated users are treated as anonymous.

Clearing Local Data

When an authenticated user signs out of the ASAP help widget, all data stored locally on the device is cleared automatically.

If local data needs to be cleared for anonymous users, use the following method:

Swift

  1. ZohoDeskPortalSDK.clearAllLocalData()

Objective-C

  1. [ZohoDeskPortalSDK clearAllLocalData];


    Access your files securely from anywhere

      Zoho CRM Training Programs

      Learn how to use the best tools for sales force automation and better customer engagement from Zoho's implementation specialists.

      Zoho CRM Training
        Redefine the way you work
        with Zoho Workplace

          Zoho DataPrep Personalized Demo

          If you'd like a personalized walk-through of our data preparation tool, please request a demo and we'll be happy to show you how to get the best out of Zoho DataPrep.

          Zoho CRM Training

            Create, share, and deliver

            beautiful slides from anywhere.

            Get Started Now


              Zoho Sign now offers specialized one-on-one training for both administrators and developers.

              BOOK A SESSION









                                            You are currently viewing the help pages of Qntrl’s earlier version. Click here to view our latest version—Qntrl 3.0's help articles.




                                                Manage your brands on social media

                                                  Zoho Desk Resources

                                                  • Desk Community Learning Series


                                                  • Digest


                                                  • Functions


                                                  • Meetups


                                                  • Kbase


                                                  • Resources


                                                  • Glossary


                                                  • Desk Marketplace


                                                  • MVP Corner


                                                  • Word of the Day


                                                    Zoho Marketing Automation

                                                      Zoho Sheet Resources

                                                       

                                                          Zoho Forms Resources


                                                            Secure your business
                                                            communication with Zoho Mail


                                                            Mail on the move with
                                                            Zoho Mail mobile application

                                                              Stay on top of your schedule
                                                              at all times


                                                              Carry your calendar with you
                                                              Anytime, anywhere




                                                                    Zoho Sign Resources

                                                                      Sign, Paperless!

                                                                      Sign and send business documents on the go!

                                                                      Get Started Now




                                                                              Zoho TeamInbox Resources



                                                                                      Zoho DataPrep Resources



                                                                                        Zoho DataPrep Demo

                                                                                        Get a personalized demo or POC

                                                                                        REGISTER NOW


                                                                                          Design. Discuss. Deliver.

                                                                                          Create visually engaging stories with Zoho Show.

                                                                                          Get Started Now









                                                                                                              • Related Articles

                                                                                                              • Introducing ASAP iOS SDK

                                                                                                                This document pertains explicitly to help widgets created using the updated new ASAP Setup. Please note that if you are using an older version of ASAP, the help widgets will be read-only. To enable the new ASAP widgets on your App, use the latest ...
                                                                                                              • Working with Tickets in the iOS App

                                                                                                                The Zoho Desk software enables users and agents to efficiently resolve customer issues. Each issue or complaint that an agent receives from customers is called a ticket. The ticket management system automates the resolution process. Now that we are ...
                                                                                                              • How to authenticate users on your Android app? 

                                                                                                                What is JWT Authentication? We have enhanced the existing mechanism to provide a better, safer, and simpler authentication process. The improved JWT Authentication mechanism verifies the authenticity of your end users and permits them to use the help ...
                                                                                                              • How to enable push notifications for the ASAP iOS SDK?

                                                                                                                You can configure the ASAP help widget to send notifications to end-users when an agent responds via chat. The critical component in making this possible on the SDK is an Apple Push Notification (APN) service certificate in the .p12 format. To ...
                                                                                                              • FAQs: Zoho GC SDK for iOS and Android

                                                                                                                Can customers use GC to raise questions? No, a customer cannot ask a question with GC. The customer can only respond to the questions or choose answers from the available options that are displayed in the flow of GC. What are the essential keys ...
                                                                                                                Wherever you are is as good as
                                                                                                                your workplace

                                                                                                                  Resources

                                                                                                                  Videos

                                                                                                                  Watch comprehensive videos on features and other important topics that will help you master Zoho CRM.



                                                                                                                  eBooks

                                                                                                                  Download free eBooks and access a range of topics to get deeper insight on successfully using Zoho CRM.



                                                                                                                  Webinars

                                                                                                                  Sign up for our webinars and learn the Zoho CRM basics, from customization to sales force automation and more.



                                                                                                                  CRM Tips

                                                                                                                  Make the most of Zoho CRM with these useful tips.



                                                                                                                    Zoho Show Resources