Memecahkan masalah Login OS

Dokumen ini menjelaskan cara memecahkan masalah Login OS menggunakan server metadata. Untuk informasi tentang cara menyiapkan Login OS atau untuk mendapatkan petunjuk langkah demi langkah, lihat Menyiapkan Login OS.

Anda dapat membuat kueri server metadata dari dalam instance Compute Engine. Untuk mengetahui informasi selengkapnya, baca Menyimpan dan mengambil metadata instance.

Sebelum memulai

  • Siapkan autentikasi jika Anda belum melakukannya. Autentikasi memverifikasi identitas Anda untuk mengakses layanan Google Cloud dan API. Untuk menjalankan kode atau contoh dari lingkungan pengembangan lokal, Anda dapat melakukan autentikasi ke Compute Engine dengan memilih salah satu opsi berikut:

    Pilih tab untuk melihat bagaimana Anda berencana menggunakan contoh di halaman ini:

    Konsol

    Saat menggunakan konsol Google Cloud untuk mengakses layanan dan API Google Cloud , Anda tidak perlu menyiapkan autentikasi.

    gcloud

    1. Instal Google Cloud CLI. Setelah penginstalan, lakukan inisialisasi Google Cloud CLI dengan menjalankan perintah berikut:

      gcloud init

      Jika Anda menggunakan penyedia identitas (IdP) eksternal, Anda harus login ke gcloud CLI dengan identitas gabungan Anda terlebih dahulu.

  • Tetapkan region dan zona default.
  • REST

    Untuk menggunakan contoh REST API di halaman ini dalam lingkungan pengembangan lokal, gunakan kredensial yang Anda berikan ke gcloud CLI.

      Instal Google Cloud CLI.

      Jika Anda menggunakan penyedia identitas (IdP) eksternal, Anda harus login ke gcloud CLI dengan identitas gabungan Anda terlebih dahulu.

    Untuk mengetahui informasi selengkapnya, lihat Melakukan autentikasi untuk menggunakan REST dalam dokumentasi autentikasi Google Cloud .

Pesan error umum

Berikut adalah contoh error umum yang mungkin Anda alami saat menggunakan Login OS.

Tidak dapat menemukan nama untuk grup

Pada beberapa instance komputasi yang menggunakan Login OS, Anda mungkin menerima pesan error berikut setelah koneksi dibuat:

/usr/bin/id: cannot find name for group ID 123456789

Abaikan pesan error ini. Error ini tidak memengaruhi instance komputasi Anda.

Gagal mendapatkan grup

Anda mungkin melihat log yang mirip dengan yang berikut ini saat membuat instance komputasi:

Dec 10 22:31:05 instance-1 google_oslogin_nss_cache[381]: oslogin_cache_refresh[381]: Refreshing group entry cache
Dec 10 22:31:05 instance-1 google_oslogin_nss_cache[381]: oslogin_cache_refresh[381]: Failure getting groups, quitting

Log ini menunjukkan bahwa organisasi Anda belum mengonfigurasi grup Linux Login OS. Abaikan pesan ini.

Prasyarat yang gagal

Anda mungkin melihat error yang mirip dengan berikut ini saat terhubung ke instance komputasi menggunakan SSH:

ERROR: (gcloud.compute.ssh) FAILED_PRECONDITION: The specified username or UID is not unique within given system ID.

Error ini terjadi saat Login OS mencoba membuat nama pengguna yang sudah ada di dalam organisasi. Hal ini biasa terjadi ketika akun pengguna dihapus dan pengguna baru dengan alamat email yang sama dibuat tidak lama setelahnya. Setelah akun pengguna dihapus, diperlukan waktu hingga 48 jam untuk menghapus informasi POSIX pengguna.

Untuk menyelesaikan masalah ini, lakukan salah satu tindakan berikut:

Batas ukuran profil Login OS terlampaui

Anda mungkin melihat salah satu error berikut saat terhubung ke instance komputasi Linux menggunakan SSH atau menggunakan SCP untuk mentransfer file:

ERROR: (gcloud.compute.ssh) FAILED_PRECONDITION: Login profile size exceeds 32 KiB. Delete profile values to make additional space.
ERROR: (gcloud.compute.scp) INVALID_ARGUMENT: Login profile size exceeds 32 KiB. Delete profile values to make additional space.

Login OS menyimpan informasi pengguna, termasuk kunci publik SSH, di akun POSIX yang memiliki batas ukuran 32 KiB per pengguna. Jika profil Login OS Anda melebihi batas ini, atau jika Anda memiliki lebih dari 64 kunci SSH di profil Anda, Anda tidak dapat menambahkan kunci SSH tambahan ke profil tersebut, sehingga Anda tidak dapat terhubung ke VM menggunakan SSH.

Untuk mengatasi error ini, lakukan tindakan berikut:

  1. Periksa ukuran profil Login OS Anda. Untuk memeriksa ukuran profil, ekspor profil ke file JSON sementara dan periksa ukuran file dengan menjalankan perintah berikut:

    gcloud compute os-login describe-profile --format="json" | wc
    

    Jika ukurannya mendekati atau melebihi 32 KiB, Anda harus menghapus kunci SSH yang tidak digunakan.

  2. Tinjau profil Login OS Anda untuk mengidentifikasi kunci SSH yang tidak digunakan:

    gcloud compute os-login describe-profile
    

    Outputnya mirip dengan hal berikut ini:

    name: '00000000000000'
    posixAccounts:
    ...
    sshPublicKeys:
     ...:
       fingerprint: ...
       key: |
         ssh-rsa AAAAB3NzaC1yc2...
       name: ...
     ...
    
  3. Hapus kunci yang tidak digunakan menggunakan perintah gcloud compute os-login ssh-keys remove:

    gcloud compute os-login ssh-keys remove --key=KEY
    

    Ganti KEY dengan sidik jari kunci atau string kunci publik SSH lengkap.

Atau, untuk menghindari pembuatan kunci baru saat terhubung ke VM, Anda dapat melakukan salah satu hal berikut:

  • Gunakan kembali key-pair yang ada dengan menentukan flag --ssh-key-file dengan perintah gcloud compute ssh:

    gcloud compute ssh VM_NAME --ssh-key-file=PATH_TO_PRIVATE_KEY
    
  • Jika Anda sering terhubung ke VM menggunakan SSH dengan gcloud CLI, buat key-pair SSH default bernama google_compute_engine di direktori .ssh/ Anda. Command line gcloud CLI menggunakan pasangan kunci ini jika ada dan tidak membuat pasangan kunci baru pada setiap koneksi. Untuk membuat pasangan kunci default, jalankan:

    ssh-keygen -t rsa -f ~/.ssh/google_compute_engine -C USERNAME -b 2048
    

    Kemudian, tambahkan kunci publik ke profil Login OS Anda:

    gcloud compute os-login ssh-keys add --key-file=~/.ssh/google_compute_engine.pub
    

Cloud Build

Jika Anda menggunakan Cloud Build dan profil Login OS akun layanan Anda melebihi batas 32 KiB, Anda mungkin mengalami kegagalan koneksi SSH dan melihat pesan error berikut: Login profile size exceeds 32 KiB.... Untuk mengatasi masalah ini, Anda dapat mengonfigurasi Cloud Build untuk menggunakan akun layanan yang ditentukan pengguna, bukan akun layanan Cloud Build default.

Untuk mencegah masalah ini terjadi di masa mendatang, tambahkan waktu habis masa berlaku untuk kunci SSH. Kunci yang sudah tidak berlaku akan otomatis dihapus dari profil login Anda 48 jam setelah masa berlakunya habis, atau saat Anda menambahkan kunci baru ke profil.

Kode respons HTTP: 429

Anda mungkin melihat error berikut saat mencoba terhubung ke instance komputasi menggunakan SSH:

Failed to validate organization user USERNAME has login permission, got HTTP response code: 429

Masalah ini disebabkan oleh pembatasan kapasitas server metadata sebesar 100 kueri per detik per instance komputasi. Batas ini tidak dapat disesuaikan. Untuk mengatasi masalah ini, tunggu beberapa detik, lalu coba hubungkan lagi.

Untuk mencegah masalah ini pada masa mendatang, coba langkah-langkah berikut:

  • Menerapkan mekanisme percobaan ulang dalam kode aplikasi. Untuk mengetahui informasi selengkapnya, lihat:
  • Menggunakan kembali koneksi SSH yang ada.
  • Kirim perintah dalam batch untuk mengurangi koneksi SSH dan kueri metadata Login OS.

Entri metadata Login OS default

Compute Engine menentukan kumpulan entri metadata default yang menyajikan informasi Login OS. Metadata default selalu ditentukan dan disetel oleh server. Kunci metadata default peka huruf besar/kecil.

Tabel berikut menjelaskan entri yang dapat Anda kueri.

Relatif terhadap http://metadata.google.internal/computeMetadata/v1/
Entri metadata Deskripsi
project/attributes/enable-oslogin Memeriksa apakah Login OS diaktifkan pada project Google Cloud saat ini.
instance/attributes/enable-oslogin Memeriksa apakah Login OS diaktifkan pada instance komputasi saat ini.
oslogin/users/ Mengambil informasi profil untuk pengguna Login OS. Anda dapat meneruskan parameter kueri seperti username, uid, pagesize, dan pagetoken.
oslogin/authorize/

Mengambil setelan izin level login atau administratif untuk pengguna Login OS.

Untuk memeriksa izin, Anda harus menentukan parameter kueri policy. Nilai parameter kebijakan harus ditetapkan ke login (untuk memeriksa izin login) atau adminLogin (untuk memeriksa akses sudo).

Memeriksa apakah Login OS dikonfigurasi

Gunakan konsol Google Cloud atau Google Cloud CLI untuk membuat kueri metadata guna menentukan apakah Login OS diaktifkan atau tidak. Login OS diaktifkan jika kunci metadata enable-oslogin ditetapkan ke TRUE dalam metadata project atau instance. Jika instance dan metadata project ditetapkan, nilai yang ditetapkan dalam metadata instance akan lebih diutamakan.

Melihat pengguna Login OS

Untuk melihat informasi profil multi-pengguna, Anda dapat menentukan parameter pagesize. Ganti pagesize dengan nilai numerik yang diperlukan.

curl "http://metadata.google.internal/computeMetadata/v1/oslogin/users?pagesize=PAGE_SIZE" -H "Metadata-Flavor: Google"

Outputnya mungkin berisi token halaman, yang dapat digunakan dalam panggilan berikutnya untuk mencantumkan lebih banyak pengguna.

Misalnya, untuk menetapkan pagesize menjadi 1, jalankan perintah berikut:

curl "http://metadata.google.internal/computeMetadata/v1/oslogin/users?pagesize=1" -H "Metadata-Flavor: Google"

Untuk mendapatkan pengguna berikutnya, tetapkan pagesize ke 1 dan pagetoken ke token halaman dari output perintah sebelumnya.

curl "http://metadata.google.internal/computeMetadata/v1/oslogin/users?pagesize=1&pagetoken=PAGE_TOKEN" -H "Metadata-Flavor: Google"

Di sebagian besar distribusi, Anda juga dapat menjalankan perintah Unix getent passwd untuk mengambil entri sandi bagi pengguna organisasi.

Melihat pengguna Login OS tertentu

Untuk melihat informasi profil bagi pengguna tertentu di instance komputasi Anda, jalankan perintah berikut:

curl "http://metadata.google.internal/computeMetadata/v1/oslogin/users?username=USERNAME" -H "Metadata-Flavor: Google"

Ganti USERNAME dengan nama pengguna yang ingin Anda kueri.

Misalnya, Anda dapat melakukan permintaan untuk mencari user_example_com pengguna. Perintah dan output berikut menunjukkan pemformatan tambahan agar lebih mudah dibaca.

curl "http://metadata.google.internal/computeMetadata/v1/oslogin/users?username=user_example_com" -H "Metadata-Flavor: Google"

Outputnya mirip dengan yang berikut ini:

{
    "loginProfiles": [{
        "name": "12345678912345",
        "posixAccounts": [{
            "primary": true,
            "username": "user_example_com",
            "uid": "123451",
            "gid": "123451",
            "homeDirectory": "/home/user_example_com",
            "operatingSystemType": "LINUX"
        }],
        "sshPublicKeys": {
            "204c4b4fb...": {
                "key": "ssh-rsa AAAAB3Nz...",
                "fingerprint": "204c4b4fb..."
            }
        }
    }]
}

Di sebagian besar distribusi, Anda juga dapat menjalankan perintah Unix seperti getent passwd username atau getent passwd uid untuk mengambil informasi profil.

Untuk mengambil kunci SSH bagi pengguna, Anda juga dapat menjalankan /usr/bin/google_authorized_keys USERNAME. Jika tidak ada kunci yang ditampilkan, pengguna mungkin tidak memiliki izin yang diperlukan untuk login ke instance komputasi.

Memeriksa izin login

Untuk melihat izin level login dan administratif, Anda harus memberikan parameter kueri policy=login&email=LOGIN_NAME.

  1. Buat kueri profil pengguna untuk mendapatkan nilai kolom name:

    curl "http://metadata.google.internal/computeMetadata/v1/oslogin/users?username=user_example_com" -H "Metadata-Flavor: Google"
  2. Dalam output, catat name.

  3. Jalankan perintah login berikut menggunakan nilai name:

    curl "http://metadata.google.internal/computeMetadata/v1/oslogin/authorize?policy=login&email=LOGIN_NAME" -H "Metadata-Flavor: Google"
    

Misalnya, Anda dapat membuat kueri izin login untuk user_example_com pengguna yang dilihat di bagian sebelumnya:

curl "http://metadata.google.internal/computeMetadata/v1/oslogin/authorize?policy=login&email=12345678912345" -H "Metadata-Flavor: Google"

Output perintah menunjukkan bahwa pengguna diberi otorisasi untuk login ke instance komputasi:

{"success":true}

Memeriksa apakah instance komputasi Anda memiliki akun layanan atau tidak

Anda dapat membuat kueri server metadata untuk menemukan akun layanan yang terkait dengan instance komputasi Anda. Login ke instance komputasi Anda dan jalankan perintah berikut:

curl "http://metadata.google.internal/computeMetadata/v1/instance/service-accounts/" -H "Metadata-Flavor: Google"

Outputnya mirip dengan hal berikut ini:

12345-sa@developer.gserviceaccount.com/
default/

Jika tidak ada akun layanan yang ditemukan, outputnya akan kosong.

Masalah SSH dengan 2FA diaktifkan

Bagian berikut menjelaskan cara Login OS dengan autentikasi 2 langkah (2FA) dikonfigurasi pada instance Anda dan cara memecahkan masalah error koneksi SSH saat 2FA diaktifkan.

Autentikasi 2 langkah

2FA menambahkan lapisan keamanan ekstra ke Login OS. Jika akun pengguna dalam organisasi Anda disusupi, akses SSH ke instance komputasi Anda tetap terlindungi hingga faktor kedua diautentikasi.

Saat Anda menetapkan kunci metadata enable-oslogin-2fa ke TRUE, agen tamu akan menambahkan konfigurasi PAM berikut untuk 2FA ke bagian atas file /etc/pam.d/sshd:

auth       [success=done perm_denied=die default=ignore] pam_oslogin_login.so

Agen tamu juga memperbarui file konfigurasi OpenSSH di seluruh sistem, /etc/ssh/sshd_config. Agen tamu tidak menghapus pasangan argumen kata kunci yang dikonfigurasi sebelumnya dari file, tetapi karena OpenSSH menggunakan nilai pertama untuk setiap parameter, agen tamu menambahkan baris berikut ke bagian atas file /etc/ssh/sshd_config:

AuthenticationMethods publickey,keyboard-interactive
ChallengeResponseAuthentication yes

Memecahkan masalah error koneksi 2FA

Saat Anda terhubung ke instance komputasi menggunakan SSH dengan 2FA diaktifkan, Cloud Shell mungkin menampilkan pesan error Permission denied (keyboard-interactive) atau not authorized umum tanpa menentukan alasan kegagalan:

Permission denied (keyboard-interactive)
ERROR: (gcloud.compute.start-iap-tunnel) Error while connecting [4033: 'not authorized'].
kex_exchange_identification: Connection closed by remote host
Connection closed by UNKNOWN port 65535

ERROR: (gcloud.compute.ssh) [/usr/bin/ssh] exited with return code [255].

Jika Anda mengalami masalah saat terhubung ke instance komputasi menggunakan SSH saat 2FA diaktifkan, ikuti langkah-langkah berikut:

  1. Untuk mengisolasi apakah masalah disebabkan oleh 2FA, batalkan penetapan kunci metadata enable-oslogin-2fa atau tetapkan ke FALSE, lalu coba hubungkan ke instance komputasi. Jika instance komputasi tetap tidak dapat diakses, masalahnya mungkin bukan pada 2FA.

  2. Jika Anda dapat mengakses instance komputasi setelah menonaktifkan 2FA, cari pesan error 2FA di file log dalam direktori /var/log/ untuk menentukan penyebab kegagalan 2FA.

  3. Saat terhubung ke instance, aktifkan kembali enable-oslogin-2fa dan periksa apakah agen tamu telah mengupdate file /etc/pam.d/sshd dan /etc/ssh/sshd_config—misalnya, dengan memeriksa stempel waktu modifikasinya dengan perintah ls -l. Pastikan file berisi entri pam_oslogin_login.so, AuthenticationMethods publickey,keyboard-interactive, dan ChallengeResponseAuthentication yes yang diperlukan yang dijelaskan dalam Autentikasi 2 langkah.

  4. Untuk memeriksa apakah koneksi gagal karena Verifikasi 2 Langkah (2SV) tidak diaktifkan di Akun Google atau domain Anda, filter log audit Login OS atau file log di direktori /var/log/ untuk pesan error berikut:

    "message": "The caller does not have permission"
    
          "@type": "type.googleapis.com/google.cloud.oslogin.v1.StartSessionRequest",
          "supportedChallengeTypes": [
            "INTERNAL_TWO_FACTOR",
            "SECURITY_KEY_OTP",
            "AUTHZEN",
            "TOTP",
            "IDV_PREREGISTERED_PHONE"
          ],
    

    Pesan error ini dicatat dalam log jika Anda belum mengaktifkan Verifikasi 2 Langkah di Akun Google atau domain Anda. Klien SSH Anda mungkin juga menampilkan error No supported authentication methods available (server sent: keyboard-interactive).

    Anda dapat memverifikasi apakah akun Anda telah mengaktifkan Verifikasi 2 Langkah di setelan keamanan Akun Google Anda. Jika akun Anda tidak mengaktifkan Verifikasi 2 Langkah, tidak ada dialog yang meminta kode keamanan, dan upaya login akan gagal dengan error Permission denied umum.

    Anda juga dapat menghubungi administrator Google Workspace untuk memverifikasi apakah Verifikasi 2 Langkah diaktifkan di domain Anda.

  5. Jika properti response.challenges dari log audit ContinueSession Login OS menampilkan status selain 'READY', hal ini mungkin mengindikasikan masalah pada verifikasi autentikasi yang Anda gunakan. Contoh berikut menunjukkan masalah terkait kode verifikasi pesan suara atau teks yang tidak dikirim ke ponsel Anda untuk menyelesaikan proses login:

    "response": {
        "challenges": [
          {
            "challengeId": 2,
            "challengeType": "IDV_PREREGISTERED_PHONE",
            "status": "RETRYABLE_ERROR"
          }
    

    Anda dapat menggunakan metode verifikasi lain, seperti Google Authenticator, untuk mempersempit masalah. Jika Anda dapat terhubung menggunakan metode verifikasi lain, tetapi tidak menerima kode verifikasi pesan teks di ponsel yang terdaftar dan melihat RETRYABLE_ERROR untuk IDV_PREREGISTERED_PHONE di log, hubungi Dukungan Google Workspace.

Langkah berikutnya