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
- import ZohoDeskPortalAPIKit
Objective-C
- @import ZohoDeskPortalAPIKit;
JWT Token
The token is passed from your app. Kindly refer to the enhanced JWT authentication mechanism.
Swift
- 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
- 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
- ohoDeskPortalSDK.logout { (isSuccess: Bool ) in
// isSuccess shows whether the logout attempt was successful
// any errors will be logged
}
Objective-C
- [ZohoDeskPortalSDK logoutOnCompletion:^(BOOL isSuccess) {
// isSuccess shows whether the logout attempt was successful
// any errors will be logged
}];
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
ZohoDeskPortalSDK.clearAllLocalData()
Objective-C
[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 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 Workerly Home
- Forums
- Connect With Us:
- Zoho Recruit Home
- Forums
- Connect With Us:
New to Zoho Writer?
Create. Review. Publish.
New to Zoho CRM Plus?
Deliver unforgettable customer experiences
New to Zoho CRM Plus?
Deliver unforgettable customer experiences
New to Zoho Marketing Plus?
Everything you need to run your marketing
New to Zoho Marketing Plus?
Everything you need to run your marketing
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.
New to Zoho Survey?
Zoho Sheet Resources
Zoho Forms Resources
New to Zoho Sign?
Zoho Sign Resources
Sign, Paperless!
New to Zoho TeamInbox?
Zoho TeamInbox Resources
New to Zoho ZeptoMail?
Design. Discuss. Deliver.
New to Zoho Workerly?
New to Zoho Recruit?
New to Zoho CRM?
New to Zoho Projects?
New to Zoho Sprints?
New to Zoho Assist?
New to Bigin?
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 ...Understanding the enhanced JWT mechanism for Authenticating Users in the ASAP Help Widget
Types of Users End-users can be categorized as guests or authenticated users based on how they log in to the ASAP add-on. Guest users Guests are users who do not sign in while logging in to the ASAP add-ons. They can access the Knowledge Base module, ...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 ...
New to Zoho LandingPage?
Zoho LandingPage Resources