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 types of authentication: 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 also 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
    } ;
ZohoDeskPortalSDK.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
    }];
After this method is implemented, 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];


    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

                                                                                                            Equipping the Help Center services as widgets to deliver instant assistance to your customers The ASAP SDK for iOS provides easy access to help your iOS app's end users. Using this SDK, you can create and customize a help widget within your app and ...
                                                                                                          • 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 ...
                                                                                                          • Working with the Zoho GC SDK for iOS

                                                                                                            Mobile applications have proven to be a significant component of business with the advent of smartphones. Businesses offer a range of services through their mobile phone applications for better customer engagement. To improve users' interest in apps, ...
                                                                                                          • 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 ...
                                                                                                            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