update databases docs

liara-cloud · Oct 6, 2024 · ff5ab17 · ff5ab17
1 parent bfc20c2
commit ff5ab17
Show file tree

Hide file tree

Showing 5 changed files with 296 additions and 1 deletion.
diff --git a/src/components/Sidebar/data.js b/src/components/Sidebar/data.js
@@ -2934,6 +2934,11 @@ export default {
         icon: <GoVersions   />,
         link: "/dbaas/mariadb/choose-version"
       },
+      {
+        title: "ایجاد و مدیریت کاربر جدید",
+        icon: <GoKey  />,
+        link: "/dbaas/mariadb/create-user"
+      },
       {
         hr: true
       },
@@ -3622,6 +3627,11 @@ export default {
         icon: <GoVersions   />,
         link: "/dbaas/redis/choose-version"
       },
+      {
+        title: "ایجاد و مدیریت کاربر جدید",
+        icon: <GoKey   />,
+        link: "/dbaas/redis/create-user"
+      },
       {
         hr: true
       },

diff --git a/src/pages/dbaas/mariadb/create-user.mdx b/src/pages/dbaas/mariadb/create-user.mdx
@@ -0,0 +1,137 @@
+import Layout from "@/components/Layout";
+import Button from "@/components/Common/button";
+import Section from "@/components/Common/section";
+import Alert from "@/components/Common/alert";
+import Tabs from "@/components/Common/tab";
+import Step from "@/components/Common/step";
+import Card from "@/components/Common/card";
+import Important from "@/components/Common/important";
+import Highlight from "@/components/Common/highlight";
+import Link from "next/link";
+import NextPage from "@/components/Common/nextpage";
+import Asciinema from "@/components/Common/asciinema";
+
+import Head from "next/head";
+
+<Layout>
+<Head>
+<title>مستندات ایجاد و مدیریت کاربر جدید در دیتابیس MariaDB - لیارا</title>
+</Head>
+# ایجاد و مدیریت کاربر جدید در دیتابیس MariaDB
+<hr className="mb-2" />
+
+وقتی که شما یک دیتابیس MariaDB جدید در لیارا، ایجاد می‌کنید؛ به صورت خودکار یک کاربر به نام root همراه با آن ایجاد می‌شود که همان دسترسی پیش‌فرض است.
+دسترسی پیش‌فرض یا کاربر <Important>root</Important> در MariaDB، یک اکانت مدیریتی با بیشترین سطح دسترسی است. این کاربر معادل administrator در سیستم‌های عامل مختلف است و می‌تواند تمام عملیات‌های مدیریتی و اجرایی در پایگاه داده را انجام دهد.
+<div className="h-2" />
+
+شما می‌توانید با استفاده از ابزارهای مختلفی نظیر mysql-cli، کاربران جدید با دسترسی‌های جدید 
+در دیتابیس خود ایجاد کنید؛ در ادامه به نحوه ساخت کاربران جدید با دسترسی‌های مختلف در دیتابیس، پرداخته شده است.
+<div className="h-2" />
+
+برای ساخت کاربر جدید در دیتابیس، در ابتدا باید <a href="/dbaas/mariadb/how-tos/connect-via-cli/mysql/" className="text-[#2196f3]">ابزار mysql-cli</a> را بر روی سیستم (یا سرور خود)، نصب کنید؛ در ادامه، بایستی با استفاده از اطلاعات موجود در بخش **نحوه اتصال** دیتابیس‌تان در لیارا و با استفاده از دستور زیر، در ترمینال، به دیتابیس با کاربر root، متصل شوید: 
+
+<div className="h-4" />
+    <div dir='ltr'>
+    <Highlight className="bash">
+        {`mysql --host <hostname> -u <username> -p<password> --port <port> -D <database_name>`}
+    </Highlight>
+    </div>
+<div className="h-4" />
+پس از اتصال موفق، می‌توانید با استفاده از دستور <Important>CREATE USER</Important>، کاربران مد نظر خود را، ایجاد کنید.
+
+<Section id="create-readonly-user" title="ساخت کاربر با دسترسی Read-Only" />
+برای ایجاد کاربر جدید که تنها اجازه خواندن اطلاعات (READ) از دیتابیس را دارد، می‌توانید از دستورات زیر استفاده کنید:
+
+
+<div className="h-4" />
+    <div dir='ltr'>
+    <Highlight className="bash">
+        {`CREATE USER 'readonly_user'@'%' IDENTIFIED BY 'password';
+GRANT SELECT ON <database_name>.* TO 'readonly_user'@'%';
+FLUSH PRIVILEGES;
+`}
+    </Highlight>
+    </div>
+<div className="h-4" />
+دستور فوق، یک کاربر با نام <Important>readonly_user</Important> و رمزعبور <Important>password</Important> ایجاد می‌کند که این کاربر می‌تواند 
+فقط داده‌ها را، در تمامی جداول موجود در دیتابیس مورد نظر، <Important>SELECT</Important> کند (بخواند).
+
+پس از ساخت کاربر، می‌توانید از مشخصات آن، استفاده کرده و به دیتابیس متصل بشوید.
+بدیهی است که کاربر ایجاد شده فوق، نمی‌تواند 
+دسترسی غیر از SELECT کردن داده‌ها را داشته باشد؛ مگر اینکه 
+دسترسی‌اش توسط کاربر root، تغییر پیدا کند.
+<Section id="create-limited-user" title="ساخت کاربر با دسترسی محدود به برخی جداول" />
+در صورتی که بخواهید کاربری ایجاد کنید که فقط به چند جدول مشخص دسترسی داشته باشد، می‌توانید مانند دستورات زیر عمل کنید:
+
+<div className="h-4" />
+    <div dir='ltr'>
+    <Highlight className="bash">
+        {`CREATE USER 'limited_user'@'%' IDENTIFIED BY 'password';
+GRANT SELECT, INSERT, UPDATE ON <database_name>.<table_name_1> TO 'limited_user'@'%';
+GRANT SELECT ON <database_name>.<table_name_2> TO 'limited_user'@'%';
+FLUSH PRIVILEGES;
+`}
+    </Highlight>
+    </div>
+<div className="h-4" />
+دستور فوق، یک کاربر به نام <Important>limited_user</Important> و رمزعبور <Important>password</Important> ایجاد می‌کند که می‌تواند 
+در جداول \<table_name_1\> و \<table_name_2\> در یک دیتابیس مشخص، عملیات <Important>SELECT</Important> , <Important>INSERT</Important> و <Important>UPDATE</Important> را، انجام دهد.
+
+بدیهی است که کاربر ایجاد شده فوق، نمی‌تواند دسترسی غیر از دسترسی‌های تعریف شده را داشته باشد؛ مگر اینکه دسترسی‌اش توسط کاربر root، تغییر پیدا کند.
+
+<Section id="create-backup-user" title="ساخت کاربر فقط برای تهیه فایل پشتیبان" />
+
+در صورتی که بخواهید کاربری ایجاد کنید که فقط 
+بتواند وارد دیتابیس شود و فایل پشتیبان از آن تهیه کند، می‌توانید مانند قطعه کد زیر، عمل کنید:
+
+<div className="h-4" />
+    <div dir='ltr'>
+    <Highlight className="bash">
+        {`CREATE USER 'backup_user'@'%' IDENTIFIED BY 'password';
+GRANT SELECT, LOCK TABLES, SHOW DATABASES ON *.* TO 'backup_user'@'%';
+FLUSH PRIVILEGES;
+`}
+    </Highlight>
+    </div>
+
+<Section id="see-user-roles" title="مشاهده دسترسی‌های یک کاربر" />
+برای مشاهده دسترسی‌های یک کاربر می‌توانید از دستور <Important>SHOW GRANTS</Important> استفاده کنید. به عنوان مثال،
+می‌توانید برای مشاهده دسترسی‌های کاربری به نام <Important>readonly_user</Important>، مانند قطعه کد زیر، عمل کنید:
+
+<div className="h-4" />
+    <div dir='ltr'>
+    <Highlight className="bash">
+        {`SHOW GRANTS FOR 'readonly_user'@'%';`}
+    </Highlight>
+    </div>
+
+<Section id="delete-user-roles" title="حذف دسترسی‌ یک کاربر" />
+برای حذف یک دسترسی کاربر، می‌توانید از دستور <Important>REVOKE</Important> استفاده کنید؛ 
+به عنوان مثال، فرض کنید که قصد دارید دسترسی <Important>UPDATE</Important> در جدول table1 از دیتابیس mydb را از کاربری به نام <Important>limited_user</Important>، سلب کنید.
+برای این‌کار، می‌توانید از نمونه قطعه کد زیر، استفاده کنید:
+<div className="h-4" />
+<div dir='ltr'>
+    <Highlight className="bash">
+        {`REVOKE UPDATE ON database_name.table1 FROM 'limited_user'@'%';
+FLUSH PRIVILEGES;
+`}
+    </Highlight>
+</div>
+
+<Section id="delete-user" title="حذف یک کاربر" />
+برای حذف کاربر می‌توانید از دستور <Important>DROP USER</Important> استفاده کنید. به عنوان مثال، 
+برای حذف کاربری به نام <Important>readonly_user</Important> می‌توانید مانند قطعه کد زیر، عمل کنید:
+<div className="h-4" />
+<div dir='ltr'>
+    <Highlight className="bash">
+        {`DROP USER 'readonly_user'@'%';`}
+    </Highlight>
+</div>
+
+<Alert variant="success">
+<p>
+همچنین بخوانید: <a href="https://dev.mysql.com/doc/refman/8.4/en/create-user.html" className="text-[#2196f3]">مستندات ایجاد کاربر در MariaDB</a>
+</p>
+</Alert>
+
+</Layout>
diff --git a/src/pages/dbaas/mongodb/create-user.mdx b/src/pages/dbaas/mongodb/create-user.mdx
@@ -69,7 +69,7 @@ db.createUser({
 
 <div className="h-4" />
     <div dir='ltr'>
-    <Highlight className="sql">
+    <Highlight className="mongodb">
         {`use admin;
 db.createUser({
   user: "limitedUser",

diff --git a/src/pages/dbaas/mysql/create-user.mdx b/src/pages/dbaas/mysql/create-user.mdx
@@ -136,4 +136,10 @@ FLUSH PRIVILEGES;
     </Highlight>
 </div>
 
+<Alert variant="success">
+<p>
+همچنین بخوانید: <a href="https://dev.mysql.com/doc/refman/8.4/en/create-user.html" className="text-[#2196f3]">مستندات رسمی ایجاد کاربر در MySQL</a>
+</p>
+</Alert>
+
 </Layout>
diff --git a/src/pages/dbaas/redis/create-user.mdx b/src/pages/dbaas/redis/create-user.mdx
@@ -0,0 +1,142 @@
+import Layout from "@/components/Layout";
+import Button from "@/components/Common/button";
+import Section from "@/components/Common/section";
+import Alert from "@/components/Common/alert";
+import Tabs from "@/components/Common/tab";
+import Step from "@/components/Common/step";
+import Card from "@/components/Common/card";
+import Important from "@/components/Common/important";
+import Highlight from "@/components/Common/highlight";
+import Link from "next/link";
+import NextPage from "@/components/Common/nextpage";
+import Asciinema from "@/components/Common/asciinema";
+
+import Head from "next/head";
+
+<Layout>
+<Head>
+<title>مستندات ایجاد و مدیریت کاربر جدید در دیتابیس Redis - لیارا</title>
+</Head>
+# ایجاد و مدیریت کاربر جدید در دیتابیس Redis
+<hr className="mb-2" />
+
+Redis از سیستم کاربران و دسترسی‌های پیچیده پشتیبانی نمی‌کند. اما با استفاده از قابلیت ACL (Access Control List) از نسخه 6.0 به بعد، می‌توانید کاربران جدید ایجاد کنید و دسترسی‌های مختلف را تنظیم کنید.
+
+
+<div className="h-2" />
+
+برای ساخت کاربر جدید در دیتابیس، در ابتدا باید <a href="/dbaas/redis/how-tos/connect-via-cli/redis-cli" className="text-[#2196f3]">ابزار redis-cli</a> را بر روی سیستم (یا سرور خود)، نصب کنید؛ در ادامه، بایستی با استفاده از اطلاعات موجود در بخش **نحوه اتصال** دیتابیس‌تان در لیارا و با استفاده از دستور زیر، در ترمینال،
+به redis متصل شوید:
+
+<div className="h-4" />
+    <div dir='ltr'>
+    <Highlight className="bash">
+        {`redis-cli -h <host_name> -p <port> -a "<password>"`}
+    </Highlight>
+    </div>
+<div className="h-4" />
+
+پس از اتصال موفق، می‌توانید با استفاده از دستورات تعریف شده در ادامه، کاربران مد نظر خود را، ایجاد کنید.
+
+<Section id="create-readonly-user" title="ساخت کاربر با دسترسی Read-Only " />
+برای ایجاد کاربر جدید که تنها اجازه خواندن اطلاعات (READ) از دیتابیس را دارد، 
+می‌توانید از دستور زیر استفاده کنید:
+
+<div className="h-4" />
+    <div dir='ltr'>
+    <Highlight className="Redis">
+        {`ACL SETUSER readonly_user on >password123 ~* +@read -@write`}
+    </Highlight>
+    </div>
+<div className="h-4" />
+
+دستور فوق، یک کاربر با نام <Important>readonly_user</Important> و رمزعبور <Important>password123</Important> با اجازه دسترسی به تمامی کلیدها (با استفاده از <Important>*~</Important>) 
+و فقط اجازه خواندن آن‌ها (<Important>read+@</Important>)
+و منع تغییر آن‌ها (<Important>write-@</Important>)، ایجاد می‌کند. حال برای اتصال به redis با این کاربر ایجاد شده، می‌توانید از دستور زیر در ترمینال، استفاده کنید:
+
+<div className="h-4" />
+    <div dir='ltr'>
+    <Highlight className="Redis">
+        {`redis-cli -h fitz-roy.liara.cloud -p 30612 -a "password123" --user readonly_user`}
+    </Highlight>
+    </div>
+
+<Section id="create-limited-user" title="ساخت کاربر با دسترسی محدود به برخی کلیدها" />
+در صورتی که بخواهید کاربری ایجاد کنید که فقط به کلیدهای مشخص دسترسی داشته باشد، می‌توانید مانند دستور زیر عمل کنید:
+
+<div className="h-4" />
+    <div dir='ltr'>
+    <Highlight className="redis">
+        {`ACL SETUSER limited_user on >password456 ~user_* +@read +@write`}
+    </Highlight>
+    </div>
+<div className="h-4" />
+
+دستور فوق، یک کاربر با نام <Important>limited_user</Important> و رمزعبور <Important>password456</Important> با اجازه دسترسی به کلیدهایی که با <Important>_user</Important> شروع می‌شوند (با استفاده از <Important>*_user~</Important>) 
+و اجازه خواندن آن‌ها (<Important>read+@</Important>)
+و تغییر آن‌ها (<Important>write+@</Important>)، ایجاد می‌کند. حال برای اتصال به redis با این کاربر ایجاد شده، می‌توانید از دستور زیر در ترمینال، استفاده کنید:
+
+<div className="h-4" />
+    <div dir='ltr'>
+    <Highlight className="Redis">
+        {`redis-cli -h fitz-roy.liara.cloud -p 30612 -a "password456" --user limited_user`}
+    </Highlight>
+    </div>
+
+<Section id="create-backup-user" title="ساخت کاربر برای تهیه فایل پشتیبان" />
+برای ایجاد کاربر جدید که تنها اجازه تهیه فایل پشتیبان از دیتابیس را دارد، 
+می‌توانید مانند دستور زیر عمل کنید:
+
+<div className="h-4" />
+    <div dir='ltr'>
+    <Highlight className="Redis">
+        {`ACL SETUSER backup_user on >password789 ~* +@admin`}
+    </Highlight>
+    </div>
+<div className="h-4" />
+
+دستور فوق، یک کاربر با نام <Important>backup_user</Important> و رمزعبور <Important>password789</Important> با اجازه دسترسی به همه کلیدها (با استفاده از <Important>*~</Important>) 
+و اجازه 
+دسترسی به دستورات مدیریتی مثل SAVE و BGSAVE (<Important>admin+@</Important>) ایجاد می‌کند.
+
+<Section id="delete-user" title="حذف یک کاربر" />
+
+برای حذف یک کاربر، می‌توانید از دستور <Important>ACL DELUSER</Important> استفاده کنید. به عنوان مثال، اگر بخواهید کاربری به نام <Important>readonly_user</Important> را حذف کنید، می‌توانید از دستور زیر استفاده کنید:
+
+<div className="h-4" />
+<div dir='ltr'>
+    <Highlight className="Redis">
+        {`ACL DELUSER readonly_user`}
+    </Highlight>
+</div>
+
+<Section id="manage-users" title="مدیریت کاربران" />
+
+برای مشاهده لیست کاربران می‌توانید با دسترسی ادمین، از دستور زیر، استفاده کنید:
+
+<div className="h-4" />
+<div dir='ltr'>
+    <Highlight className="Redis">
+        {`ACL LIST`}
+    </Highlight>
+</div>
+<div className="h-4" />
+
+برای بررسی دسترسی‌های یک کاربر خاص نیز، می‌توانید مانند قطعه کد زیر عمل کنید: 
+<div className="h-4" />
+<div dir='ltr'>
+    <Highlight className="bash">
+        {`ACL GETUSER readonly_user`}
+    </Highlight>
+</div>
+<div className="h-4" />
+دستور فوق، دسترسی‌های کاربری به نام <Important>readonly_user</Important> را، نمایش می‌دهد.
+
+<div className="h-4" />
+<Alert variant="success">
+<p>
+همچنین بخوانید: <a href="https://redis.io/docs/latest/commands/acl-setuser/" className="text-[#2196f3]">مستندات رسمی ایجاد کاربر در Redis</a>
+</p>
+</Alert>
+
+</Layout>