Skip to content

Authentication

Authentication module will be used by Connection. This module allows authenticating with the Kintone app by password authenticator or API token authenticator. This module is also supported the basic authenticator.

Warning

  • If both the Token and the Password Authentication are specified, the Token Authentication will be ignored and the Password authentication will be used.

Constructor

Parameter

(none)

Sample code

Init authentication module Source code

    let kintoneAuth = Auth()

Methods

setPasswordAuth(username, password)

Set password authentication for the Authentication module.

Parameter

Name Type Required Description
username String yes The username that is able to authenticate on the kintone app
password String yes The password that is able to authenticate on the kintone app

Return

Auth

Sample code

Set password authentication Source code

    let username: String? = "cybozu";
    let password: String? = "cybozu";
    kintoneAuth.setPasswordAuth(username, password);

setApiToken(apiTokenString)

Set Api Token for the Authentication module.

Parameter

Name Type Required Description
apiToken String yes The apiToken that is able to authenticate on kintone app

Return

Auth

Set APIToken authentication Source code

    let apiToken: String? = "123456789abcdefghijklmnopqrstuvwxyz";
    kintoneAuth.setApiToken(apiToken);

setBasicAuth(username, password)

Set Basic authentication for the Authentication module.

Parameter

Name Type Required Description
username String yes The username that is able to authenticate on the kintone app
password String yes The password that is able to authenticate on the kintone app

Return

Auth

Sample code

Set basic authentication Source code

    let username: String?  = "cybozu";
    let password: String? = "cybozu";
    kintoneAuth.setBasicAuth(username, password);

createHeaderCredentials()

Provide the list of HTTP Headers which use to authentication in.

Parameter

(none)

Return

Array<HTTPHeader>

Sample code

Provide the list of HTTP Headers which use to authentication in Source code

    let loginName: String? = "your_user_login_name"
    let loginPassword: String? = "your_password"
    let basicLoginName: String? = "your_basic_login_name"
    let basicLoginPassword: String? = "your_basic_password"
    let apiToken: String? = "your_api_token"

    let auth = Auth()
    auth.setBasicAuth(basicLoginName, basicLoginPassword)
    auth.setPasswordAuth(loginName, loginPassword)
    auth.setApiToken(apiToken)

    let headers: [HTTPHeader?] = auth.createHeaderCredentials()
    var count = 0
    for header in headers {
        print("Key[" + count.description + "]: " + (header?.getKey())!)
        print("Value[" + count.description + "]: " + (header?.getValue())!)
        count += 1
    }

setClientCert(certData, password)

Set certificate by certificate data

Parameter

Name Type Required Description
certData Data yes Data read from certificate file received from kintone
password String yes The password from kintone to decode the cert file

Return

Auth

Sample code

Set certificate by certificate data Source code

    let certPassword = "YOUR_CERT_PASSWORD"
    let testBundle = Bundle(for: type(of: self))

    let certData = try! Data(contentsOf: testBundle.url(forResource: "YOUR_CERT_NAME", withExtension: "YOUR_CERT_EXTENSION")!)
    auth.setClientCert(certData, certPassword)

    let conn = Connection("YOUR_DOMAIN", auth, -1)

setClientCertByPath(certPath, password)

Set certificate by path

Parameter

Name Type Required Description
certPath String yes Path to kintone certificate file
password String yes The password from kintone to decode the cert file

Return

Auth

Sample code

Set certificate by path Source code

    let certPassword = "YOUR_CERT_PASSWORD"
    let testBundle = Bundle(for: type(of: self))

    let pathURLString = testBundle.url(forResource: "YOUR_CERT_NAME", withExtension: "YOUR_CERT_EXTENSION")
    auth.setClientCertByPath(pathURLString!.absoluteString, certPassword)

    let conn = Connection("YOUR_DOMAIN", auth, -1)