Home
/
Chat
/
iOS

Authentication

In order to use the features of the Chat SDK in your client apps, a SBDMain instance must be initiated in each client app through user authentication with Sendbird server. The instance communicates and interacts with the server using an authenticated user account, and is allowed to use the Chat SDK's features. This page explains how to authenticate your user with the server.


Initialize with APP_ID

To use our chat features, you must initialize a SBDMain instance by passing the APP_ID of your Sendbird application as an argument to a parameter of the initWithApplicationId: method. The initWithApplicationId: must be called once across your client app. Generally, initialization is implemented in the user login view controller.

Objective-C
Swift
Light Color Skin
Copy
// Initialize SBDMain instance to use APIs in your app.
[SBDMain initWithApplicationId:APP_ID];
Light Color Skin
Copy
// Initialize SBDMain instance to use APIs in your app.
SBDMain.initWithApplicationId(APP_ID)

Connect to Sendbird server with a user ID

By default, Sendbird server can authenticate a user just by a unique user ID. Then the server queries the database to check for a match upon the request for connection. If no matching user ID is found, the server creates a new user account with the user ID. The ID must be unique within a Sendbird application to be distinguished from others, such as a hashed email address or phone number in your service.

This authentication procedure is useful when in development or if your service doesn't require additional security.

Note: Go to the Event delegate page to learn more about the usages of the Chat SDK's delegates and callbacks.

Objective-C
Swift
Light Color Skin
Copy
// The USER_ID below should be unique to your Sendbird application. 
[SBDMain connectWithUserId:USER_ID completionHandler:^(SBDUser * _Nullable user, SBDError * _Nullable error) {
    if (error != nil) {
        // Handle error.
    }

    // The user is connected to Sendbird server.
    ...
}];
Light Color Skin
Copy
// The USER_ID below should be unique to your Sendbird application. 
SBDMain.connect(withUserId: USER_ID, completionHandler: { (user, error) in 
    guard error == nil else {
        // Handle error.
    }

    // The user is connected to Sendbird server.
    ...
})

Note: You must connect to Sendbird server before calling any methods through the Chat SDK (apart from initializing a SBDMain instance). If you attempt to call a method without connecting, a SBDErrorConnectionRequired (800101) error would be returned.


Connect to Sendbird server with a user ID and an access token

Using Chat Platform API, you can create a user along with their own access token, or issue an access token for an existing user. Once an access token is issued, a user is required to provide the access token when logging in to the Sendbird application.

  1. Using the Chat API, create a Sendbird user account with the information submitted when a user signs up or in to your service.
  2. Save the user ID along with the issued access token to your persistent storage which is securely managed.
  3. When the user attempts to log in to the application, load the user ID and access token from the storage, and then pass them to the connectWithUserId:accessToken:completionHandler: method.
  4. Periodically replacing the user's access token is recommended to protect the account.

Note: From Settings > Application > Security > Access token permission setting in your dashboard, you are able to prevent users without an access token from logging in to your Sendbird application or restrict their access to read and write messages.

Objective-C
Swift
Light Color Skin
Copy
// The USER_ID below should be unique to your Sendbird application. 
[SBDMain connectWithUserId:USER_ID accessToken:ACCESS_TOKEN completionHandler:^(SBDUser * _Nullable user, SBDError * _Nullable error) {
    if (error != nil) {
        // Handle error.
    }

    // The user is authenticated using the access token and is connected to Sendbird server.
    ...
}];
Light Color Skin
Copy
// The USER_ID below should be unique to your Sendbird application. 
SBDMain.connect(withUserId: USER_ID, accessToken: ACCESS_TOKEN, completionHandler: { (user, error) in
    guard error == nil else {
        // Handle error.
    }

    // The user is authenticated using the access token and is connected to Sendbird server.
    ...
})

Note: For security reasons, you can also use a session token when a user logs in to Sendbird server instead of an access token. Go to the Access token vs. Session token section from the Chat API guide to learn more.


Disconnect from Sendbird server

A user should be disconnected from Sendbird server when they no longer need to receive messages from an online state. However, the user will still receive push notifications for new messages from group channels they've joined.

When disconnected, all event delegates in a user's client app registered by the addChannelDelegate:identifier: or addConnectionDelegate:identifier: stop receiving event callbacks from the server. Then, all internally cached data in the client app, such as the channels that are cached when the getChannelWithUrl:completionHandler: method of the SBDOpenChannel or SBDGroupChannel is called, are also flushed.

Note: By default, most of the data related to users, channels, and messages are internally cached in the SBDMain instance of a user's client app, which are retrieved by the corresponding query instances or received through the event delegates.

Objective-C
Swift
Light Color Skin
Copy
[SBDMain disconnectWithCompletionHandler:^{
    // The current user is disconnected from Sendbird server.
    ...
}];
Light Color Skin
Copy
SBDMain.disconnect(completionHandler: {
    // The current user is disconnected from Sendbird server.
    ...
})

Update user profile

Using the updateCurrentUserInfoWithNickName: method, you can update a user's nickname and profile image with a URL.

Objective-C
Swift
Light Color Skin
Copy
[SBDMain updateCurrentUserInfoWithNickname:NICKNAME profileUrl:PROFILE_URL completionHandler:^(SBDError * _Nullable error) {
    if (error != nil) {
        // Handle error.
    }

    // The current user's profile is successfully updated.
    // You could redraw the profile in a view in response to this operation.
    ...
}];
Light Color Skin
Copy
SBDMain.updateCurrentUserInfo(withNickname: NICKNAME, profileUrl: PROFILE_URL, completionHandler: { (error) in
    guard error == nil else {
        // Handle error.
    }

    // The current user's profile is successfully updated.
    // You could redraw the profile in a view in response to this operation.
    ...
})

Or, you can directly upload a profile image like the following:

Objective-C
Swift
Light Color Skin
Copy
[SBDMain updateCurrentUserInfoWithNickname:NICKNAME profileImage:PROFILE_FILE completionHandler:^(SBDError * _Nullable error) {
    if (error != nil) {
        // Handle error.
    }

    // A new profile images is successfully uploaded to Sendbird server.
    // You could redraw the profile in a view in response to this operation.
    ...
}];
Light Color Skin
Copy
SBDMain.updateCurrentUserInfo(withNickname: NICKNAME, profileImage: PROFILE_FILE, completionHandler: { (error) in
    guard error == nil else {
        // Handle error.
    }

    // A new profile images is successfully uploaded to Sendbird server.
    // You could redraw the profile in a view in response to this operation.
    ...
})

Note: A user's profile image can be a JPG (.jpg), JPEG (.jpeg), or PNG (.png) file of up to 25 MB.