forked from GitHub-Mirror/riotX-android
59 lines
2.2 KiB
Kotlin
59 lines
2.2 KiB
Kotlin
/*
|
|
* Copyright 2019 New Vector Ltd
|
|
*
|
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
|
* you may not use this file except in compliance with the License.
|
|
* You may obtain a copy of the License at
|
|
*
|
|
* http://www.apache.org/licenses/LICENSE-2.0
|
|
*
|
|
* Unless required by applicable law or agreed to in writing, software
|
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
* See the License for the specific language governing permissions and
|
|
* limitations under the License.
|
|
*/
|
|
|
|
package im.vector.matrix.android.api.auth
|
|
|
|
import im.vector.matrix.android.api.MatrixCallback
|
|
import im.vector.matrix.android.api.auth.data.HomeServerConnectionConfig
|
|
import im.vector.matrix.android.api.auth.data.SessionParams
|
|
import im.vector.matrix.android.api.session.Session
|
|
import im.vector.matrix.android.api.util.Cancelable
|
|
|
|
/**
|
|
* This interface defines methods to authenticate to a matrix server.
|
|
*/
|
|
interface Authenticator {
|
|
|
|
/**
|
|
* @param homeServerConnectionConfig this param is used to configure the Homeserver
|
|
* @param login the login field
|
|
* @param password the password field
|
|
* @param callback the matrix callback on which you'll receive the result of authentication.
|
|
* @return return a [Cancelable]
|
|
*/
|
|
fun authenticate(homeServerConnectionConfig: HomeServerConnectionConfig, login: String, password: String, callback: MatrixCallback<Session>): Cancelable
|
|
|
|
/**
|
|
* Check if there is an authenticated [Session].
|
|
* @return true if there is at least one active session.
|
|
*/
|
|
fun hasAuthenticatedSessions(): Boolean
|
|
|
|
/**
|
|
* Get the last authenticated [Session], if there is an active session.
|
|
* @return the last active session if any, or null
|
|
*/
|
|
fun getLastAuthenticatedSession(): Session?
|
|
|
|
/**
|
|
* Get an authenticated session. You should at least call authenticate one time before.
|
|
* If you logout, this session will no longer be valid.
|
|
*
|
|
* @param sessionParams the sessionParams to open with.
|
|
* @return the associated session if any, or null
|
|
*/
|
|
fun getSession(sessionParams: SessionParams): Session?
|
|
} |