Kueri kebijakan akses kondisional dengan API ListConditionalAccessPolicies - Identity as a Service - Alibaba Cloud - Identity as a Service

Menampilkan daftar kebijakan akses bersyarat.

Deskripsi operasi

Mengkueri kebijakan akses bersyarat dengan paginasi.

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

Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.
API: API yang dapat Anda panggil untuk melakukan aksi tersebut.
Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.
Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.
- Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.
- Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.
Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.
Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

Action

Access level

Resource type

Condition key

Dependent action

eiam:ListConditionalAccessPolicies

list

*ConditionalAccessPolicy

acs:eiam:{#regionId}:{#accountId}:instance/{#InstanceId}/conditionalaccesspolicy/*

None

Parameter permintaan

Parameter	Type	Required	Description	Example
InstanceId	string	Yes	ID instans.	idaas_ue2jvisn35ea5lmthk267xxxxx
NextToken	string	No	Token untuk halaman hasil berikutnya.	NTxxxxxexample
MaxResults	integer	No	Jumlah entri per halaman.	20
PreviousToken	string	No	Token untuk halaman hasil sebelumnya.	PTxxxxxexample

Elemen respons

Element	Type	Description	Example
	object
RequestId	string	ID permintaan.	0441BD79-92F3-53AA-8657-F8CE4A2B912A
TotalCount	integer	Jumlah total item dalam daftar.	100
NextToken	string	Nilai token kueri yang dikembalikan oleh panggilan ini.	NTxxxexample
ConditionalAccessPolicies	array<object>	Kumpulan kebijakan akses bersyarat.
	array<object>
InstanceId	string	ID instans.	idaas_ksvv5c7f2l6uzh6oqspeks23ni
ConditionalAccessPolicyId	string	ID kebijakan akses bersyarat.	cp_xxxxx
ConditionalAccessPolicyName	string	Nama kebijakan akses bersyarat.	My policy
Description	string	Deskripsi kebijakan akses bersyarat.	My policy description
ConditionalAccessPolicyType	string	Tipe kebijakan akses bersyarat.	arn:alibaba:idaas:authn:access:policy:system
Status	string	Status aktif/nonaktif kebijakan akses bersyarat.	disabled
DecisionType	string	Tipe eksekusi kebijakan akses bersyarat.	enforcement
EvaluateAt	string	Titik evaluasi kebijakan akses bersyarat.	arn:alibaba:idaas:authn:access:rule:eval_at:after_step1
Priority	integer	Prioritas, berkisar dari 1 hingga 100.	1
DecisionConfig	object	Aksi eksekusi kebijakan akses bersyarat.
Effect	string	Tindakan keputusan kebijakan akses bersyarat: deny Tolak allow Izinkan	deny
MfaType	string	Tipe MFA Kebijakan Akses Bersyarat	directly_access
MfaAuthenticationIntervalSeconds	integer	Interval autentikasi ulang untuk kebijakan akses bersyarat (dalam detik) 300-86400	300
MfaAuthenticationMethods	array	Tipe MFA yang diizinkan oleh kebijakan akses bersyarat
	string	Tipe MFA yang diizinkan oleh kebijakan akses bersyarat, dengan opsi berikut: ia_otp_sms: Kode verifikasi SMS ia_otp_email: Kode verifikasi email ia_totp: Kata sandi dinamis OTP ia_webauthn: WebAuthn	ia_otp_email
ActiveSessionReuseStatus	string	Apakah mengaktifkan penggunaan ulang sesi untuk autentikasi sekunder	disabled
ConditionsConfig	object	Kondisi kebijakan akses bersyarat.
Applications	object	Aplikasi target kebijakan akses bersyarat
IncludeApplications	array	Aplikasi yang dipilih
	string	ID Aplikasi	app_xxxxx
ExcludeApplications	array	Aplikasi yang dikecualikan
	string	ID Aplikasi	app_xxxxx
Users	object	Pengguna target kebijakan akses bersyarat
IncludeUsers	array	Pengguna yang dipilih
	string	ID Pengguna	user_xxxxx
ExcludeUsers	array	Pengguna yang dikecualikan
	string	ID Pengguna	user_xxxxx
IncludeGroups	array	Grup pengguna yang disertakan
	string	ID Grup Pengguna	group_xxxxx
ExcludeGroups	array	Grup pengguna yang dikecualikan
	string	ID Grup Pengguna	group_xxxxx
IncludeOrganizationalUnits	array	Organisasi yang disertakan
	string	ID Organisasi	ou_xxxxx
ExcludeOrganizationalUnits	array	Organisasi yang dikecualikan
	string	ID Organisasi	ou_xxxxx
NetworkZones	object	Zona jaringan untuk kebijakan akses bersyarat
IncludeNetworkZones	array	Rentang jaringan yang disertakan
	string	ID rentang jaringan yang dipilih	network_xxxxx
ExcludeNetworkZones	array	Zona jaringan yang dikecualikan
	string	ID zona jaringan yang dikecualikan	network_xxxxx
CreateTime	integer	Pengatur waktu pembuatan.	1741857554000
LastUpdatedTime	integer	Pengatur waktu pembaruan.	1741857554000
PreviousToken	string	Token kueri halaman sebelumnya.	PTxxxxxexample

Contoh

Respons sukses

JSONformat

{
  "RequestId": "0441BD79-92F3-53AA-8657-F8CE4A2B912A",
  "TotalCount": 100,
  "NextToken": "NTxxxexample",
  "ConditionalAccessPolicies": [
    {
      "InstanceId": "idaas_ksvv5c7f2l6uzh6oqspeks23ni",
      "ConditionalAccessPolicyId": "cp_xxxxx",
      "ConditionalAccessPolicyName": "My policy",
      "Description": "My policy description",
      "ConditionalAccessPolicyType": "arn:alibaba:idaas:authn:access:policy:system",
      "Status": "disabled",
      "DecisionType": "enforcement",
      "EvaluateAt": "arn:alibaba:idaas:authn:access:rule:eval_at:after_step1",
      "Priority": 1,
      "DecisionConfig": {
        "Effect": "deny",
        "MfaType": "directly_access",
        "MfaAuthenticationIntervalSeconds": 300,
        "MfaAuthenticationMethods": [
          "ia_otp_email"
        ],
        "ActiveSessionReuseStatus": "disabled"
      },
      "ConditionsConfig": {
        "Applications": {
          "IncludeApplications": [
            "app_xxxxx"
          ],
          "ExcludeApplications": [
            "app_xxxxx"
          ]
        },
        "Users": {
          "IncludeUsers": [
            "user_xxxxx"
          ],
          "ExcludeUsers": [
            "user_xxxxx"
          ],
          "IncludeGroups": [
            "group_xxxxx"
          ],
          "ExcludeGroups": [
            "group_xxxxx"
          ],
          "IncludeOrganizationalUnits": [
            "ou_xxxxx"
          ],
          "ExcludeOrganizationalUnits": [
            "ou_xxxxx"
          ]
        },
        "NetworkZones": {
          "IncludeNetworkZones": [
            "network_xxxxx"
          ],
          "ExcludeNetworkZones": [
            "network_xxxxx"
          ]
        }
      },
      "CreateTime": 1741857554000,
      "LastUpdatedTime": 1741857554000
    }
  ],
  "PreviousToken": "PTxxxxxexample"
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.