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];


      Create. Review. Publish.

      Write, edit, collaborate on, and publish documents to different content management platforms.

      Get Started Now


        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





                              Quick Links Workflow Automation Data Collection
                              Web Forms Enterprise Begin Data Collection
                              Interactive Forms Workplace Data Collection App
                              CRM Forms Customer Service Accessible Forms
                              Digital Forms Marketing Forms for Small Business
                              HTML Forms Education Forms for Enterprise
                              Contact Forms E-commerce Forms for any business
                              Lead Generation Forms Healthcare Forms for Startups
                              Wordpress Forms Customer onboarding Order Forms for Small Business
                              No Code Forms Construction RSVP tool for holidays
                              Free Forms Travel
                              Prefill Forms Non-Profit

                              Intake Forms Legal
                              Mobile App
                              Form Designer HR
                              Mobile Forms
                              Card Forms Food Offline Forms
                              Assign Forms Photography
                              Mobile Forms Features
                              Translate Forms Real Estate Kiosk in Mobile Forms
                              Electronic Forms

                              Notification Emails for Forms Alternatives Security & Compliance
                              Holiday Forms Google Forms alternative  GDPR
                              Form to PDF Jotform alternative HIPAA Forms
                              Email Forms
                              Encrypted Forms
                              Embeddable Forms
                              Secure Forms
                              Drag & drop form builder
                              WCAG

                                    Create. Review. Publish.

                                    Write, edit, collaborate on, and publish documents to different content management platforms.

                                    Get Started Now




                                                      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


                                                            • Desk Community Learning Series


                                                            • Digest


                                                            • Functions


                                                            • Meetups


                                                            • Kbase


                                                            • Resources


                                                            • Glossary


                                                            • Desk Marketplace


                                                            • MVP Corner


                                                            • Word of the Day


                                                            • Ask the Experts


                                                              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 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