全部产品
Search

搜索本产品

    ：GetLoginToken

    文档中心

    ：GetLoginToken

    更新时间：Feb 05, 2026

    Mendapatkan token logon.

    Coba sekarang

    Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

    Test

    RAM authorization

    Tidak ada otorisasi untuk operasi ini. Jika Anda mengalami masalah saat menjalankan operasi ini, hubungi dukungan teknis.

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    RegionId

    string

    Yes

    ID wilayah. Panggil DescribeRegions untuk mendapatkan daftar wilayah yang didukung oleh WUYING Workspace.

    cn-hangzhou
    ClientId

    string

    Yes

    ID unik yang dihasilkan oleh client.

    f4a0dc8e-1702-4728-9a60-95b27a35****
    DirectoryId

    string

    No

    ID jaringan kantor. Parameter ini sama dengan OfficeSiteId. Kami menyarankan Anda menggunakan OfficeSiteId sebagai gantinya. Anda tidak dapat menentukan DirectoryId dan OfficeSiteId secara bersamaan.

    cn-hangzhou+dir-885351****
    OfficeSiteId

    string

    No

    ID jaringan kantor.

    cn-hangzhou+dir-885351****
    SessionId

    string

    No

    ID session logon.

    • Jika Anda belum mengikat perangkat autentikasi multi-faktor (MFA) virtual atau belum mengaktifkan autentikasi dua faktor untuk client, jangan tentukan SessionId.

    • Jika perangkat MFA virtual telah diikat atau autentikasi dua faktor telah diaktifkan untuk client, tentukan SessionId pada tahap autentikasi logon setelah tahap ADPassword. Dapatkan SessionId dari respons permintaan GetLoginToken yang berada dalam tahap ADPassword untuk autentikasi akun convenience.

    cd45e873-650d-4d70-acb9-f996187a****
    CurrentStage

    string

    No

    Tahap saat ini dalam autentikasi logon. Tahapan-tahapan tersebut berurutan:

    • ADPassword: Memverifikasi informasi pengguna. Tentukan nilai ini untuk autentikasi berbasis password yang menggunakan akun convenience atau akun Active Directory (AD).

    • MFABind: Mengikat perangkat MFA virtual.

    • MFAVerify: Memverifikasi kode keamanan yang dihasilkan oleh perangkat MFA virtual.

    • TokenVerify: Melakukan autentikasi dua faktor untuk client.

    • ChangePassword: Mengubah password pengguna.

    • KeepAliveVerify: Menukar `KeepAliveToken` yang valid menjadi `LoginToken`.

    ADPassword
    EndUserId

    string

    No

    Username pengguna convenience atau pengguna AD. Parameter ini wajib ditentukan ketika CurrentStage diatur ke ADPassword.

    alice
    Password

    string

    No

    Password pengguna convenience atau pengguna AD. Parameter ini wajib ditentukan ketika CurrentStage diatur ke ADPassword.

    Password1234
    OldPassword

    string

    No

    Password lama. Parameter ini wajib ditentukan ketika CurrentStage diatur ke ChangePassword.

    OldPassword
    NewPassword

    string

    No

    Password baru. Parameter ini wajib ditentukan ketika CurrentStage diatur ke ChangePassword.

    NewPassword
    AuthenticationCode

    string

    No

    Kode keamanan yang dihasilkan oleh perangkat MFA virtual. Parameter ini wajib ditentukan ketika CurrentStage diatur ke MFAVerify.

    47****
    ClientOS

    string

    No

    Sistem operasi perangkat tempat client dijalankan.

    Windows_NT 10.0.18363 x64
    ClientVersion

    string

    No

    Versi client. Jika Anda menggunakan client WUYING Workspace, temukan parameter ini di kotak dialog About pada antarmuka logon client.

    2.1.0-R-20210731.151756
    TokenCode

    string

    No

    Jika Anda mengaktifkan autentikasi dua faktor untuk client di Konsol WUYING Workspace dan terdeteksi ancaman logon untuk pengguna saat ini, kode verifikasi untuk autentikasi dua faktor akan dikirim ke alamat email end user. Parameter ini wajib ditentukan ketika CurrentStage diatur ke TokenVerify.

    63****
    KeepAlive

    boolean

    No

    Menentukan apakah tetap login.

    Valid values:

    • null :

      Tidak tetap login. [Nilai default]

    • true :

      Tetap login.

    • false :

      Tidak tetap login.

    false
    KeepAliveToken

    string

    No

    Token yang digunakan untuk tetap login. Setelah pengguna berhasil login dan mengaktifkan fitur tetap login, API akan mengembalikan KeepAliveToken. Selama periode validitas KeepAliveToken, panggil operasi GetLoginToken dan atur CurrentStage ke KeepAliveVerify untuk menukar KeepAliveToken menjadi token logon (`LoginToken`). Parameter ini wajib ditentukan ketika CurrentStage diatur ke KeepAliveVerify.

    hide
    Uuid

    string

    No

    Pengidentifikasi unik client. Jika Anda menggunakan client WUYING Workspace, temukan parameter ini di kotak dialog About pada antarmuka logon client.

    C78CA9E99315687575DD2844C1F3****
    ClientType

    string

    No

    Jenis client software WUYING Workspace.

    Valid values:

    • HTML5 :

      Client web

    • WINDOWS :

      Client Windows

    • MACOS :

      Client macOS

    • IOS :

      Client iOS

    • ANDROID :

      Client Android

    WINDOWS
    AvailableFeatures

    object

    No

    string

    No

    ClientName

    string

    No

    Elemen respons

    Element

    Type

    Description

    Example

    object

    Informasi yang dikembalikan.

    Email

    string

    Alamat email pengguna. Dikembalikan bersama LoginToken setelah login berhasil.

    • Untuk pengguna convenience, ini adalah alamat email yang ditetapkan saat pengguna convenience dibuat.

    • Untuk pengguna Active Directory (AD), formatnya adalah username@Nama domain AD.

    alice
    Secret

    string

    Kunci yang digunakan untuk mengikat perangkat MFA virtual. Parameter ini digunakan dalam tahap MFABind.

    Catatan

    Untuk informasi lebih lanjut tentang tahapan autentikasi, lihat deskripsi parameter permintaan CurrentStage.

    5OCLLKKOJU5HPBX66H3QCTWYI7MH****
    RequestId

    string

    ID permintaan.

    1CBAFFAB-B697-4049-A9B1-67E1FC5F****
    EndUserId

    string

    Username akun convenience atau pengguna AD.

    alice
    LoginToken

    string

    Token logon.

    v18101ac6a9e69c66b04a163031680463660b4b216cd758f34b60b9ad6a7c7f7334b83dd8f75eef4209c68f9f1080b****
    NextStage

    string

    Tahap berikutnya yang diharapkan. Misalnya, jika administrator mengaktifkan MFA di Konsol WUYING Workspace, parameter ini akan mengembalikan MFAVerify setelah username dan password diverifikasi (setelah tahap ADPassword). Hal ini menunjukkan bahwa MFA diperlukan.

    Catatan

    Untuk informasi lebih lanjut tentang tahapan autentikasi, lihat deskripsi parameter permintaan CurrentStage.

    MFAVerify
    QrCodePng

    string

    Kode QR dari kunci yang digunakan untuk mengikat perangkat MFA virtual. Nilainya dienkripsi Base64. Parameter ini bisa kosong dan digunakan dalam tahap MFABind.

    Catatan

    Untuk informasi lebih lanjut tentang tahapan autentikasi, lihat deskripsi parameter permintaan CurrentStage.

    5OCLLKKOJU5HPBX66H3QCTWY******
    Label

    string

    Properti pengguna convenience. Jika pengguna adalah pengguna AD, parameter ini kosong.

    test:wuying
    SessionId

    string

    ID session. Parameter ini hanya dikembalikan ketika Anda memanggil GetLoginToken untuk pertama kalinya dalam session yang sama. Jika diperlukan beberapa autentikasi, sertakan parameter ini pada tahap selanjutnya.

    Catatan

    Untuk informasi lebih lanjut tentang tahapan autentikasi, lihat deskripsi parameter permintaan CurrentStage.

    d6ec166d-ab93-4286-bf7f-a18bb929****
    Phone

    string

    Nomor ponsel pengguna convenience. Jika pengguna adalah pengguna AD, parameter ini kosong.

    1381111****
    TenantId

    integer

    ID akun Alibaba Cloud. Digunakan untuk identifikasi client perangkat keras.

    166353906220****
    KeepAliveToken

    string

    Token yang digunakan untuk tetap login. Setelah pengguna berhasil login dan mengaktifkan fitur tetap login, API akan mengembalikan KeepAliveToken. Jika fitur tetap login tidak diaktifkan, parameter ini kosong.

    006YwvYMsesWWsDBZnVB+Wq9AvJDVIqOY3YCktvtb7+KxMb3ClnNlV8+l/knhZYrXUmeP06IzkjF+IgcZ3vZKOyMprDyFHjCy1r27FRE/U7+geWCl8iQ+yF8GaCRHfJEkC2+ROs93HkT4tfHxyY1J8W7O7ZQGUC/cdCvm+cCP6FIy73IUuPuVR6PcKYXIpEZPW
    Industry

    string
    Catatan

    Ini adalah parameter internal dan tidak tersedia untuk publik.

    edu
    Props

    object
    Catatan

    Ini adalah parameter internal dan tidak tersedia untuk publik.

    string
    Catatan

    Ini adalah parameter internal dan tidak tersedia untuk publik.

    {'dingUserName': u'\u674e\u66fc', 'role': 'student'}
    WindowDisplayMode

    string
    Catatan

    Ini adalah parameter internal dan tidak tersedia untuk publik.

    mode
    RiskVerifyInfo

    object

    Informasi tentang deteksi ancaman logon.

    Email

    string

    Saat verifikasi identitas dipicu, alamat email ini digunakan untuk verifikasi.

    user@example.com
    LastLockDuration

    integer

    Waktu saat akun dikunci.

    1713749778
    Locked

    string

    Menunjukkan apakah akun dikunci.

    Valid values:

    • true :

      Ya

    • false :

      Tidak

    true
    Phone

    string

    Saat verifikasi identitas dipicu, nomor ponsel ini digunakan untuk verifikasi.

    1381111****
    Reason

    string
    Catatan

    Ini adalah parameter internal dan tidak tersedia untuk publik.

    null
    PasswordStrategy

    object
    Catatan

    Ini adalah parameter internal dan tidak tersedia untuk publik.

    TenantPasswordLength

    string
    Catatan

    Ini adalah parameter internal dan tidak tersedia untuk publik.

    null
    TenantAlternativeChars

    array
    Catatan

    Ini adalah parameter internal dan tidak tersedia untuk publik.

    string
    Catatan

    Ini adalah parameter internal dan tidak tersedia untuk publik.

    null
    NickName

    string

    WyId

    string

    Contoh

    Respons sukses

    JSONformat

    {
  "Email": "alice",
  "Secret": "5OCLLKKOJU5HPBX66H3QCTWYI7MH****",
  "RequestId": "1CBAFFAB-B697-4049-A9B1-67E1FC5F****",
  "EndUserId": "alice",
  "LoginToken": "v18101ac6a9e69c66b04a163031680463660b4b216cd758f34b60b9ad6a7c7f7334b83dd8f75eef4209c68f9f1080b****",
  "NextStage": "MFAVerify",
  "QrCodePng": "5OCLLKKOJU5HPBX66H3QCTWY******",
  "Label": "test:wuying",
  "SessionId": "d6ec166d-ab93-4286-bf7f-a18bb929****",
  "Phone": "1381111****",
  "TenantId": 0,
  "KeepAliveToken": "006YwvYMsesWWsDBZnVB+Wq9AvJDVIqOY3YCktvtb7+KxMb3ClnNlV8+l/knhZYrXUmeP06IzkjF+IgcZ3vZKOyMprDyFHjCy1r27FRE/U7+geWCl8iQ+yF8GaCRHfJEkC2+ROs93HkT4tfHxyY1J8W7O7ZQGUC/cdCvm+cCP6FIy73IUuPuVR6PcKYXIpEZPW",
  "Industry": "edu",
  "Props": {
    "key": "{'dingUserName': u'\\u674e\\u66fc', 'role': 'student'}"
  },
  "WindowDisplayMode": "mode",
  "RiskVerifyInfo": {
    "Email": "user@example.com",
    "LastLockDuration": 1713749778,
    "Locked": "true",
    "Phone": "1381111****"
  },
  "Reason": "null",
  "PasswordStrategy": {
    "TenantPasswordLength": "null",
    "TenantAlternativeChars": [
      "null"
    ]
  },
  "NickName": "",
  "WyId": ""
}

    Kode kesalahan

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.