# WHOAMI

> الدالة WHOAMI في StackQL: إرجاع معرف كيان الأمان للجهة المستدعية المصادق عليها عند تمكين إدارة الوصول.

Source: https://stackql.io/ar/language-spec/functions/session/whoami

تعيد معرف كيان الأمان للجهة المستدعية المصادق عليها.  تتطلب جلسة بدأت مع تمكين [إدارة الوصول](/command-line-usage/access-management).  متاحة في StackQL من الإصدار `v1.0` فصاعدًا.

راجع أيضًا:  
[[` GROUPS `]](/language-spec/functions/session/groups) [[ إدارة الوصول ]](/command-line-usage/access-management)

* * * 

## بناء الجملة

```sql
SELECT WHOAMI() [ AS <alias> ];
```

## الوسيطات

لا يوجد.

## القيمة المرجعة

تعيد سلسلة نصية تمثل معرف كيان الأمان الذي تم تأسيسه للجملة الحالية.  تفشل الدالة في جلسة بدأت بدون `--access.config`.

* * *

## أمثلة

### فحص الهوية التي تم تأسيسها

لا تأخذ الدالتان أي وسيطات، وتصفان الجهة المستدعية التي صادق عليها الخادم لهذه الجملة.  تعيد الدالة `whoami()` معرف كيان الأمان وتعيد الدالة `groups()` مجموعات الدليل الخاصة بالجهة المستدعية، لذلك فإن تشغيلهما معًا وسيلة سريعة للتحقق من أن الرمز المميز أو الشهادة يقابل كيان الأمان المتوقع قبل تشغيل أي شيء آخر.

```sql
SELECT whoami() AS principal, groups() AS memberships;
```
