Authentication and Users
Every user has to authenticate with ConnectyCube before using any ConnectyCube functionality.
When someone connects with an application using ConnectyCube, the application will need to obtain a session token which provides temporary, secure access to ConnectyCube APIs.
A session token is an opaque string that identifies a user and an application.
Create session token
Section titled “Create session token”As a starting point, the user’s session token needs to be created allowing user any further actions within the app. Pass login/email and password to identify a user:
ConnectyCube().signIn(user: userToLogin, successCallback: {(user) in
}) { (error) in
}[CYBRequest logInWithUserLogin:@"userLogin" password:@"userPassword" successBlock:^(CYBUser *user) {
} errorBlock:^(NSError *error) {
}];Request.logIn(withUserLogin: "userLogin", password: "userPassword", successBlock: { (user) in
}) { (error) in
}Authentication via phone number
Section titled “Authentication via phone number”Sign In with phone number is supported with Firebase integration.
The whole guide on how to create Firebase project, connect Firebase SDK and implement authentication via phone number is available at our Firebase Setup Guide. Please follow it.
Authentication via external identity provider
Section titled “Authentication via external identity provider”Custom Identity Provider (CIdP) feature is necessary if you have your own user database and want to authenticate users in ConnectyCube against it. It works the same way as Facebook/Twitter SSO.
With Custom Identity Provider feature you can continue use your user database instead of storing/copying user data to ConnectyCube database.
CIdP high level integration flow
Section titled “CIdP high level integration flow”To get started with CIdP integration, check the Custom Identity Provider guide which describes high level integration flow.
How to login via CIdP
Section titled “How to login via CIdP”Once you done with the setup mapping in ConnectyCube Dashboard, it’s time to verify the integration. To perform CIdP login, the same ConnectyCube User Login API is used. You just use existing login request params to pass your external user token:
let user: ConnectycubeUser = ConnectycubeUser()user.login = "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6MTIzNDU2Nzg5LCJuYW1lIjoiSm9zZXBoIn0.OpOSSw7e485LOP5PrzScxHb7SR6sAOMRckfFwi4rp7o"
ConnectyCube().signIn(user: userToLogin, successCallback: {(user) in
}) { (error) in
}Once the login is successful, ConnectyCube will create an underalying User entity, so then you can use ConnectyCube APIs in a same way as you do with a normal login. With CIdP we do not have/store any user password in ConnectyCube User entity.
Following further integration, you may need to connect to Chat. In a case of CIdP login, you do not have a user password. In such cases you should use ConnectyCube session token as a password for chat connection. Follow the Connect to Chat with CIdP guide.
Session expiration
Section titled “Session expiration”Expiration time for session token is 2 hours after the last request to API is made. But you do not need to worry about it - with the automatic session token management it will be renewed automatically with next request to API (only v1 for now).
Destroy session token
Section titled “Destroy session token”To destroy a session use the following code:
ConnectyCube().destroySession(successCallback: {
}) { (error) in
}[CYBRequest destroySessionWithSuccessBlock:^() {
} errorBlock:^(NSError *error) {
}];Request.destroySession(successBlock: {
}) { (error) in
}User signup
Section titled “User signup”let user: ConnectycubeUser = ConnectycubeUser()user.login = "marvin18"user.password = "supersecurepwd"user.email = "awesomeman@gmail.com"user.fullName = "Marvin Simon"user.phone = "47802323143"user.website = "https://dozensofdreams.com"user.tags = "iphone, apple"
ConnectyCube().signUp(user: user, successCallback: {(user) in
}) { (error) in
}CYBUser *user = [CYBUser user];user.login = @"marvin18";user.password = @"supersecurepwd";user.email = @"awesomeman@gmail.com";user.fullName = @"Marvin Simon";user.phone = @"47802323143";user.website = @"https://dozensofdreams.com";user.tags = @[@"iphone", @"apple"];
[CYBRequest signUp:user successBlock:^(CYBUser *user) {
} errorBlock:^(NSError *error) {
}];let user = User()user.login = "marvin18"user.password = "supersecurepwd"user.email = "awesomeman@gmail.com"user.fullName = "Marvin Simon"user.phone = "47802323143"user.website = "https://dozensofdreams.com"user.tags = ["iphone", "apple"]
Request.signUp(user, successBlock: { (user) in
}) { (error) in
}Only login (or email) + password are required. Other fields are optional.
User profile update
Section titled “User profile update”let user: ConnectycubeUser = ConnectycubeUser()user.login = "marvin18"user.fullName = "Marvin Simon"
ConnectyCube().updateUser(user: user, successCallback: {(user) in
}) { (error) in
}CYBUpdateUserParameters *updateParameters = [CYBUpdateUserParameters new];updateParameters.login = @"marvin18";updateParameters.fullName = @"Marvin Simon";
[CYBRequest updateCurrentUser:updateParameters successBlock:^(CYBUser *user) {
} errorBlock:^(NSError *error) {
}];let updateParameters = UpdateUserParameters()updateParameters.login = "marvin18"updateParameters.fullName = "Marvin Simon"
Request.updateCurrentUser(updateParameters, successBlock: { (user) in
}) { (error) in
}If you want to change your password, you need to provide 2 parameters: password and oldPassword. An updated user entity will be returned.
User avatar
Section titled “User avatar”You can set a user’s avatar. You just need to upload it to the ConnectyCube cloud storage and then connect to the user.
let imageFilePath = ""ConnectyCube().uploadFile(filePath: imageFilePath, public: false, successCallback: {(cubeFile) in let customData = ["avatar_uid" : cubeFile.uid] if let theJSONData = try? JSONSerialization.data(withJSONObject: customData, options: .prettyPrinted) { user.customData = String(data: theJSONData, encoding: .utf8) } ConnectyCube().updateUser(user: user, successCallback: {(user) in }) { (error) in }
}, errorCallback: { (error) in
}, progress: { (progress) in
})UIImage *image = ...NSData *fileData = UIImagePNGRepresentation(image);
[CYBRequest uploadFileWithData:fileData fileName:@"FileName" contentType:@"image/png" isPublic:false progressBlock:^(float progress) {
} successBlock:^(CYBBlob *blob) {
NSDictionary *customData = @{@"avatar_uid" : blob.UID}; NSData *jsonData = [NSJSONSerialization dataWithJSONObject:customData options:NSJSONWritingPrettyPrinted error:nil]; NSString *jsonCustomData = [[NSString alloc] initWithData:jsonData encoding:NSUTF8StringEncoding]; CYBUpdateUserParameters *parameters = [[CYBUpdateUserParameters alloc] init]; parameters.customData = jsonCustomData;
[CYBRequest updateCurrentUser:parameters successBlock:^(CYBUser *user) {
} errorBlock:^(NSError *error) {
}]; } errorBlock:^(NSError *error) {
}];let image = ...let data = UIImagePNGRepresentation(image!)Request.uploadFile(with: data!, fileName: "FileName", contentType: "image/png", isPublic: false, progressBlock: { (progress) in}, successBlock: { (blob) in
let parameters = UpdateUserParameters() let customData = ["avatar_uid" : blob.uid] if let theJSONData = try? JSONSerialization.data(withJSONObject: customData, options: .prettyPrinted) { parameters.customData = String(data: theJSONData, encoding: .utf8) }
Request.updateCurrentUser(parameters, successBlock: { (user) in
}, errorBlock: { (error) in
})}) { (error) in
}Now, other users can get your avatar:
let user = ...if let data = user.customData?.data(using: .utf8) { if let customData = try? JSONSerialization.jsonObject(with: data, options: []) as? [String : String] { let avatarUID = customData["avatar_uid"] let privateAvatarUrl = ConnectycubeFileKt.getPrivateUrlForUID(uid: avatarUID) }}CYBUser *user = ...NSData *jsonData = [user.customData dataUsingEncoding:NSUTF8StringEncoding];NSDictionary *customData = [NSJSONSerialization JSONObjectWithData:jsonData options:kNilOptions error:nil];NSString *avatarUDID = customData[@"avatar_uid"];NSString *privateUrl = [CYBBlob privateUrlForFileUID:avatarUDID];let user = ...if let data = user.customData?.data(using: .utf8) { if let customData = try? JSONSerialization.jsonObject(with: data, options: []) as! [String : String] { let avatarUID = customData["avatar_uid"] let privateAvatarUrl = Blob.privateUrl(forFileUID: avatarUID) }}Password reset
Section titled “Password reset”It’s possible to reset a password via email:
ConnectyCube().resetPassword(email: "user@mail.com", successCallback: {
}) { (error) in
}[CYBRequest resetUserPasswordWithEmail:@"user@mail.com" successBlock:^() {
} errorBlock:^(NSError *error) {
}];Request.resetUserPassword(withEmail: "user@mail.com", successBlock: {
}) { (error) in
}If provided email is valid - an email with password reset instruction will be sent to it.
Retrieve users
Section titled “Retrieve users”Retrieve users by ID
Section titled “Retrieve users by ID”let paginator = RequestPagination(page: 0, itemsPerPage: 10)let sorter = RequestSorter(fieldName: "created_at", sortType: OrderType.shared.ASC)
ConnectyCube().getUsersByIds(ids: [21, 22], pagination: paginator, sorter: sorter, successCallback: {(result) in let users = result.items}) { (error) in
}CYBPaginator *paginator = [CYBPaginator limit:10 skip:0];[CYBRequest usersWithIDs:@[@"21",@"22"] paginator:paginator successBlock:^(CYBPaginator *paginator, NSArray *users) {
} errorBlock:^(NSError *error) {
}];let paginator = Paginator(limit:10, skip: 0)Request.users(withIDs: ["21","22"], paginator: paginator, successBlock: { (paginator, users) in
}) { (error) in
}Retrieve user by login
Section titled “Retrieve user by login”ConnectyCube().getUserByLogin(login: "amigo", successCallback: {(user) in
}) { (error) in
}[CYBRequest userWithLogin:@"amigo" successBlock:^(CYBUser *user) {
} errorBlock:^(NSError *error) {
}];Request.user(withLogin: "amigo", successBlock: { (user) in
}) { (error) in
}Retrieve user by email
Section titled “Retrieve user by email”ConnectyCube().getUserByEmail(email: "amigo@mail.com", successCallback: {(user) in
}) { (error) in
}[CYBRequest userWithEmail:@"amigo@mail.com" successBlock:^(CYBUser *user) {
} errorBlock:^(NSError *error) {
}];Request.user(withEmail: "amigo@mail.com", successBlock: { (user) in
}) { (error) in
}Retrieve users by full name
Section titled “Retrieve users by full name”let paginator = RequestPagination(page: 0, itemsPerPage: 10)let sorter = RequestSorter(fieldName: "created_at", sortType: OrderType.shared.ASC)
ConnectyCube().getUsersByFullName(fullName: "Marvin", pagination: paginator, sorter: sorter, successCallback: {(result) inlet users = result.items}) { (error) in
}CYBPaginator *paginator = [CYBPaginator limit:10 skip:0];[CYBRequest usersWithFullName:@"Marvin" paginator:paginator successBlock:^(CYBPaginator *paginator, NSArray *users) {
} errorBlock:^(NSError *error) {
}];let paginator = Paginator(limit:10, skip: 0)Request.users(withFullName: "Marvin", paginator: paginator, successBlock: { (paginator, users) in
}) { (error) in
}Retrieve user by phone number
Section titled “Retrieve user by phone number”ConnectyCube().getUserByPhoneNumber(phone: "+4427123314", successCallback: {(user) in
}) { (error) in
}CYBPaginator *paginator = [CYBPaginator limit:10 skip:0];[CYBRequest usersWithPhoneNumbers:@[@"+4427123314"] paginator:paginator successBlock:^(CYBPaginator *paginator, NSArray *users) {
} errorBlock:^(NSError *error) {
}];let paginator = Paginator(limit:10, skip: 0)Request.users(withPhoneNumbers: ["+4427123314"], paginator: paginator, successBlock: { (paginator, users) in
}) { (error) in
}Retrieve user by external ID
Section titled “Retrieve user by external ID”ConnectyCube().getUserByExternalId(id: "3789", successCallback: {(user) in
}) { (error) in
}[CYBRequest userWithExternalID:3789 successBlock:^(CYBUser *user) {
} errorBlock:^(NSError *error) {
}];Request.user(withExternalID: 3789, successBlock: { (user) in
}) { (error) in
}Retrieve users by tags
Section titled “Retrieve users by tags”let paginator = RequestPagination(page: 0, itemsPerPage: 10)let sorter = RequestSorter(fieldName: "created_at", sortType: OrderType.shared.ASC)
ConnectyCube().getUsersByTags(tags: ["iphone"], pagination: paginator, sorter: sorter, successCallback: {(result) inlet users = result.items}) { (error) in
}CYBPaginator *paginator = [CYBPaginator limit:10 skip:0];[CYBRequest usersWithTags:@[@"iphone"] paginator:paginator successBlock:^(CYBPaginator *paginator, NSArray *users) {
} errorBlock:^(NSError *error) {
}];let paginator = Paginator(limit:10, skip: 0)Request.users(withTags: ["iphone"], paginator: paginator, successBlock: { (paginator, users) in
}) { (error) in
}Delete user
Section titled “Delete user”A user can delete himself from the platform:
ConnectyCube().deleteUser(successCallback: {
}) { (error) in
}[CYBRequest deleteCurrentUserWithSuccessBlock:^() {
} errorBlock:^(NSError *error) {
}];Request.deleteCurrentUser(successBlock: {
}) { (error) in
}