Pengguna mewakili akun yang diautentikasi yang dapat mengakses organisasi dan
entitas dalam organisasi tersebut, seperti lingkungan, proxy API, dan keystore.
Untuk menambahkan pengguna baru ke organisasi Apigee, Anda harus memberikan akses ke akun
pengguna, pertama-tama di project Cloud, lalu di UI Apigee. (Dokumen ini menggunakan istilah pengguna dan akun pengguna secara bergantian.)
Saat menambahkan pengguna baru, biasanya Anda:
Di Konsol, tetapkan pengguna baru ke satu atau beberapa peran di project Cloud Anda. Tindakan ini memberi pengguna akses luas ke semua lingkungan di organisasi.
Di UI Apigee, berikan peran pengguna tambahan di satu atau beberapa
lingkungan dalam organisasi Apigee Anda. Perhatikan bahwa peran pengguna yang tercakup dalam lingkungan tidak menggantikan
peran yang diberikan di tingkat Google Cloud; peran tersebut bersifat tambahan.
Kemampuan yang Anda berikan kepada akun pengguna bergantung pada jenis peran yang Anda tetapkan kepadanya. Peran adalah kumpulan izin.
Anda tidak dapat memberikan izin kepada pengguna secara langsung. Sebagai gantinya, mereka akan diberi peran. Misalnya, Anda dapat menetapkan developer ke peran API Admin sehingga mereka dapat membuat proxy API, KVM, dan alur bersama. Untuk seseorang yang akan men-deploy
proxy, Anda dapat menetapkannya ke peran Environment Admin, yang memberi mereka kemampuan untuk
men-deploy dan membatalkan deployment revisi proxy API. Untuk mengetahui detail tentang semua peran Apigee, lihat
Peran Apigee.
Selain itu, resource yang dapat diakses pengguna berdasarkan perannya bergantung pada tempat
Anda menetapkan peran:
Project Google Cloud - Jika Anda menetapkan peran di Konsol (di project Google Cloud),
pengguna tersebut dapat mengakses semua resource Apigee—semua lingkungan dan resource dalam
lingkungan tersebut—dalam peran tersebut. Hal ini karena project Cloud adalah induk
UI Apigee dalam hierarki resource; izin yang ditetapkan pada induk (project Cloud)
diwarisi oleh semua turunan (lingkungan). Anda dapat menyempurnakan akses ini dengan
menentukan peran pengguna berdasarkan per lingkungan di UI Apigee.
Kontrol akses di Google Cloud Platform dikontrol oleh Identity and Access Management (IAM). IAM memungkinkan Anda menetapkan izin yang menentukan siapa yang memiliki jenis akses apa ke resource mana di project Anda. Untuk
mengetahui informasi selengkapnya, lihat Konsep yang terkait dengan
identitas.
Pengguna adalah jenis akun utama, istilah luas yang mengacu pada identitas yang dapat diberi
akses ke resource. Jenis akun utama Cloud lainnya mencakup akun layanan, grup Google, dan domain G Suite. Untuk mengetahui informasi selengkapnya, lihat
ringkasan ini tentang Cloud Identity and Access Management.
Akses lingkungan - Memberi peran pengguna untuk lingkungan tertentu
tidak menggantikan peran yang ditetapkan di tingkat project Google Cloud. Di tingkat lingkungan,
peran yang diberikan kepada pengguna ditampilkan sebagai gabungan dengan peran Cloud apa pun yang ditetapkan kepada pengguna.
Misalnya, jika Anda menetapkan pengguna sebagai API Admin di project Cloud, pengguna tersebut akan memiliki akses—sebagai
API Admin—ke semua lingkungan di organisasi Anda.
Rekomendasi peran
Apigee merekomendasikan agar Anda melakukan hal berikut untuk setiap akun pengguna baru yang Anda tambahkan. (Jika menambahkan
pengguna super atau administrator, tindakan ini tidak diperlukan.):
Di Konsol, tambahkan akun pengguna baru dan pilih peran yang memiliki serangkaian izin minimal. Misalnya, tetapkan peran pengguna baru ke API Admin. Lihat Mengelola akses di Google Cloud.
Di tampilan Akses Lingkungan UI Apigee, tambahkan pengguna dan tetapkan peran pengguna tambahan untuk setiap lingkungan di organisasi seperti yang dijelaskan dalam Mengelola pengguna. Perhatikan
bahwa peran yang ditetapkan dalam cakupan lingkungan di UI Apigee tidak menggantikan peran yang ditetapkan di tingkat Google Cloud,
melainkan bersifat tambahan.
[[["Mudah dipahami","easyToUnderstand","thumb-up"],["Memecahkan masalah saya","solvedMyProblem","thumb-up"],["Lainnya","otherUp","thumb-up"]],[["Sulit dipahami","hardToUnderstand","thumb-down"],["Informasi atau kode contoh salah","incorrectInformationOrSampleCode","thumb-down"],["Informasi/contoh yang saya butuhkan tidak ada","missingTheInformationSamplesINeed","thumb-down"],["Masalah terjemahan","translationIssue","thumb-down"],["Lainnya","otherDown","thumb-down"]],["Terakhir diperbarui pada 2025-08-21 UTC."],[[["\u003cp\u003eThis document applies to both Apigee and Apigee hybrid, and it details how to manage user accounts within an Apigee organization.\u003c/p\u003e\n"],["\u003cp\u003eAdding a new user involves assigning roles in both the Google Cloud project and the Apigee UI, granting them access to organization-wide resources and specific environments, respectively.\u003c/p\u003e\n"],["\u003cp\u003eRoles assigned at the Google Cloud project level provide broad access across all environments, while roles assigned in the Apigee UI offer additive, environment-specific permissions.\u003c/p\u003e\n"],["\u003cp\u003eApigee recommends assigning minimal permissions at the Cloud project level and then refining access in the Apigee UI for each specific environment, ensuring a granular control over user access.\u003c/p\u003e\n"],["\u003cp\u003eUser roles determine the capabilities a user has, based on a collection of permissions, such as creating API proxies, deploying, and undeploying API proxy revisions.\u003c/p\u003e\n"]]],[],null,["# Users and roles\n\n*This page\napplies to **Apigee** and **Apigee hybrid**.*\n\n\n*View [Apigee Edge](https://docs.apigee.com/api-platform/get-started/what-apigee-edge) documentation.*\n\nA *user* represents an authenticated account that can access an organization and the\nentities within that organization, such as the environments, API proxies, and keystores.\n\nTo add a new user to your Apigee organization, you grant access to the user's *account,* first in the Cloud project and then in the Apigee UI. (This document uses the terms *user*\nand *user account* interchangeably.)\n\nWhen you add a new user, you typically:\n\n1. **In the Console** , assign the new user to one or more roles in your Cloud project. This gives the user broad access to all environments in the organization.\n\n For more information, see\n [Managing access in the\n Console](/apigee/docs/api-platform/system-administration/manage-access).\n2. **In the Apigee UI** , grant additional user roles in one or more environments in your Apigee organization. Note that environment-scoped user roles do not supersede roles granted at the Google Cloud level; they are additive.\n\n For more information, see\n [Manage users in the\n Apigee UI](/apigee/docs/api-platform/system-administration/manage-users).\n\n| **Note:** You do not have to assign the same role for a user in the Apigee UI for each environment that you assigned to the user for the Cloud project.\n\nAbout roles\n-----------\n\nThe capabilities that you grant to the user account depend on the type of *role* that you\nassign to them. A role is a collection of [permissions](/iam/docs/overview#permissions).\nYou cannot grant a permission to the user directly. Instead, you grant them a role. For\nexample, you might assign a developer to the role of `API Admin` so that\nthey can create API proxies, , and shared flows. For someone that will deploy\nproxies, you might assign them to the role of `Environment Admin`, which grants them the ability to\ndeploy and undeploy API proxy revisions. For details about all Apigee roles, see\n[Apigee roles](/apigee/docs/api-platform/system-administration/apigee-roles).\n\nAdditionally, the resources that a user can access based on their role depends on *where*\nyou assigned the role:\n\n- **Google Cloud project** - If you assign a role in the Console (on the Google Cloud project), then the user can access all Apigee resources---*all environments and resources within\n those environments* ---in that role. This is because the Cloud project is the *parent* of the Apigee UI in the resource hierarchy; the permissions set on the parent (the Cloud project) are inherited by all children (environments). You can refine this access by specifying user roles on a *per environment* basis in the Apigee UI.\n\n Access control in Google Cloud Platform is controlled by Identity and Access Management\n (IAM). IAM lets you set permissions specifying **who** has\n **what** kind of access to **which** resources in your project. For\n more information, see [Concepts related to\n identity](/iam/docs/overview#concepts_related_identity).\n\n Users are a type of *principal* , a broad term that refers to an identity that can be granted\n access to resources. Other types of Cloud principals include service accounts, Google groups, and G Suite\n domains. For more information, see\n [this overview](/iam/docs/overview#concepts_related_identity) of Cloud Identity and\n Access Management.\n- **Environment access** - Granting a user role for a specific environment does not supersede roles set at the Google Cloud project level. At the environment level, roles granted to a user are represented as a union with any Cloud roles assigned to the user.\n\nFor example, if you define a user as an `API Admin` on the Cloud project, then that user will have access---as an\n`API Admin`--- to all environments in your organization.\n\n### Role recommendations\n\nApigee recommends that you do the following for each new user account that you add. (When adding\n*super users* or administrators, this is not necessary.):\n\n1. In the Console, add the new user account and select a role that has a minimal set of permissions. For example, set the role of a new user to `API Admin`. See [Managing access in Google Cloud](/apigee/docs/api-platform/system-administration/manage-access).\n2. In the Apigee UI's **Environment Access** view, add the user and set any additional user roles for each environment in the organization as described in [Manage users](/apigee/docs/api-platform/system-administration/manage-users). Note that environment-scoped roles set in the Apigee UI do not supersede roles set at the Google Cloud level, they are additive.\n\n*[KVM]: Key Value Map"]]
