کلید عمومی و خصوصی سامانه مودیان همان امضای دیجیتال شما برای ارسال صورتحساب الکترونیکی است. بدون این جفت‌کلید، سامانه نمی‌تواند مطمئن شود درخواست از طرف مؤدی معتبر آمده است؛ برای همین خیلی از خطاهای «شناسه یکتا»، «کلید» یا «امضای بسته» از همین‌جا شروع می‌شود.

کلید عمومی و خصوصی چیست؟

در سامانه مودیان، برای هر اتصال امن معمولاً یک جفت کلید ساخته می‌شود:

  • کلید خصوصی (Private Key): مثل رمز اصلی شماست. فقط باید نزد خودتان و داخل نرم‌افزار واسط بماند. با این کلید، بسته صورتحساب امضا می‌شود.
  • کلید عمومی (Public Key): نسخه‌ای است که در کارپوشه بارگذاری می‌کنید. سامانه با کمک آن، امضای شما را بررسی می‌کند.

این دو کلید با هم ساخته می‌شوند و باید از یک مجموعه باشند. اگر کلید عمومی کارپوشه با کلید خصوصی نرم‌افزار یکی نباشد، ارسال معمولاً رد می‌شود.

i
به زبان ساده: کلید خصوصی امضا می‌کند؛ کلید عمومی همان امضا را تأیید می‌کند. یکی بدون دیگری کامل نیست.

چرا سامانه مودیان به کلید نیاز دارد؟

سامانه مودیان بستر رسمی صدور و ارسال صورتحساب الکترونیکی است. قبل از پذیرش داده، باید بداند:

  1. فرستنده همان مؤدی ثبت‌شده در کارپوشه است
  2. محتوای ارسالی در مسیر تغییر نکرده است

کلید خصوصی برای امضای دیجیتال و کلید عمومی برای راستی‌آزمایی همان امضا به کار می‌رود. نتیجه این کار، اتصال امن بین نرم‌افزار واسط (مثل آساد)، کارپوشه و سامانه است.

CSR چیست و چه ربطی به کلید دارد؟

CSR (Certificate Signing Request) درخواستی است که با اطلاعات مؤدی ساخته می‌شود و از روی آن مسیر دریافت یا تولید کلید و گواهی طی می‌شود. در عمل، کاربر معمولاً این مراحل را می‌بیند:

  1. انتخاب نوع شخص (حقیقی یا حقوقی)
  2. ورود نام فارسی و انگلیسی، شناسه ملی یا کد ملی و ایمیل
  3. ساخت فایل CSR و جفت کلید عمومی و خصوصی
  4. بارگذاری کلید عمومی در کارپوشه
  5. دریافت شناسه یکتای حافظه مالیاتی و ثبت آن در نرم‌افزار

اگر یکی از این حلقه‌ها ناقص باشد—مثلاً کلید عمومی با خصوصی هم‌خوان نباشد یا شناسه یکتا غیرفعال باشد—با خطاهای مربوط به کلید، امضا یا عدم مجوز ارسال روبه‌رو می‌شوید.

مفهوم کلید عمومی و خصوصی در سامانه مودیان برای ارسال صورتحساب الکترونیکی
کلید خصوصی نزد شما می‌ماند؛ کلید عمومی در کارپوشه ثبت می‌شود

تفاوت کلید عمومی و خصوصی در یک نگاه

مورد کلید خصوصی کلید عمومی
نقش امضای صورتحساب بررسی و تأیید امضا
محل نگهداری نرم‌افزار / سیستم امن شما کارپوشه سامانه مودیان
اشتراک‌گذاری هرگز با دیگران به اشتراک نگذارید برای ثبت در کارپوشه لازم است
اگر اشتباه باشد امضا رد می‌شود سامانه امضا را نمی‌پذیرد

مسیر عملی از ساخت کلید تا ارسال موفق

  1. اطلاعات مؤدی را دقیق وارد کنید. فرق حقیقی و حقوقی در شناسه و عنوان مهم است.
  2. کلید و CSR را از مسیر معتبر بسازید. ترجیحاً همان ابزاری که نرم‌افزار واسط معرفی می‌کند.
  3. فایل‌ها را ذخیره و نام‌گذاری منظم کنید. تا بعداً جفت اشتباه انتخاب نشود.
  4. کلید عمومی را در کارپوشه بارگذاری کنید و شناسه یکتای حافظه را بگیرید.
  5. شناسه یکتا و کلید خصوصی را در نرم‌افزار تنظیم کنید.
  6. یک صورتحساب آزمایشی بفرستید و وضعیت را استعلام کنید.
نکته کاربردی: بعد از هر بار ساخت کلید جدید، هم کارپوشه و هم تنظیمات نرم‌افزار را با همان مجموعه به‌روز کنید. نصفه‌کاره رها کردن، منبع خطاهای بعدی است.

اشتباه‌های رایج کاربران

  • ساخت کلید جدید و فراموش کردن به‌روزرسانی کارپوشه
  • استفاده از کلید عمومی یک مجموعه و کلید خصوصی مجموعه دیگر
  • غیرفعال بودن شناسه یکتای حافظه مالیاتی
  • بارگذاری ناقص فایل در تنظیمات نرم‌افزار
  • اشتراک‌گذاری کلید خصوصی با دیگران یا نگهداری در سیستم غیرامن
  • اختلاف زیاد ساعت سیستم با زمان واقعی
!
هشدار امنیتی: کلید خصوصی را در پیام‌رسان، ایمیل عمومی یا سیستم مشترک نفرستید. افشای آن یعنی امکان سوءاستفاده از امضای دیجیتال شما.

اگر خطا گرفتید، از کجا شروع کنید؟

پیام‌هایی مثل «شناسه یکتا یا کلید خصوصی اشتباه است»، «امضای بسته صحیح نیست» یا «مجاز به ارسال برای این شناسه نیستید» معمولاً به یکی از این‌ها برمی‌گردد:

  • جفت کلید هم‌خوان نیست
  • شناسه یکتا غیرفعال است یا از مسیر نادرست گرفته شده
  • گواهی منقضی یا ناقص است
  • بعد از ویرایش پرونده در کارپوشه، هنوز زمان انتظار (مثلاً ۲۴ ساعت) رعایت نشده

برای فهرست متن خطاها و اقدام پیشنهادی، صفحه رفع خطاهای سامانه مودیان را ببینید.

ساخت کلید در آساد

اطلاعات مؤدی را وارد کنید و فایل کلید عمومی، خصوصی و CSR را دریافت کنید.

تولید کلید

سؤالات متداول

کلید عمومی و خصوصی سامانه مودیان چیست؟

یک جفت کلید رمزنگاری برای امضا و تأیید هویت دیجیتال مؤدی هنگام ارسال صورتحساب الکترونیکی است. خصوصی امضا می‌کند؛ عمومی امضا را تأیید می‌کند.

بدون کلید می‌توان صورتحساب فرستاد؟

در مدل اتصال مستقیم به سامانه مودیان، خیر. امضا و شناسه یکتای حافظه بخشی از فرایند ارسال استاندارد است.

CSR چه فرقی با کلید دارد؟

CSR درخواست اولیه همراه اطلاعات هویتی است؛ کلید عمومی و خصوصی خروجی عملی همان فرایند برای امضا و ثبت در کارپوشه‌اند.

اگر کلید خصوصی را گم کنیم چه می‌شود؟

معمولاً باید فرایند ساخت کلید و دریافت شناسه یکتا را دوباره انجام دهید و تنظیمات نرم‌افزار و کارپوشه را با مجموعه جدید هماهنگ کنید.

چرا پیام «کلید اشتباه است» می‌گیرم؟

اغلب به این دلیل که کلید عمومی کارپوشه با کلید خصوصی نرم‌افزار از یک مجموعه نیست، یا شناسه یکتا غیرفعال شده است. هر دو طرف را با هم به‌روز کنید.

آیا باید کلید را در اختیار حسابدار بگذاریم؟

دسترسی عملیاتی را می‌توان مدیریت کرد، اما کلید خصوصی نباید بی‌ضابطه پخش شود. بهتر است مالکیت حساب و مسئولیت نگهداری کلید شفاف باشد.

شناسه یکتای حافظه مالیاتی چیست؟

شناسه‌ای است که پس از ثبت کلید عمومی در کارپوشه دریافت می‌کنید و در نرم‌افزار برای ارسال صورتحساب تنظیم می‌شود. بدون شناسه فعال، ارسال انجام نمی‌شود.

توجه

جزئیات کارپوشه و قواعد سازمان ممکن است به‌روز شود. همیشه آخرین راهنمای رسمی سازمان امور مالیاتی و پیام همان لحظه سامانه را ملاک قرار دهید.

جمع‌بندی

کلید عمومی و خصوصی سامانه مودیان پایه اعتماد دیجیتال برای ارسال صورتحساب الکترونیکی است. کلید خصوصی را امن نگه دارید، کلید عمومی را درست در کارپوشه ثبت کنید و شناسه یکتای حافظه را فعال بگذارید. اگر این سه مورد هم‌خوان باشند، بخش مهمی از خطاهای امضا و دسترسی برطرف می‌شود.

برای شروع اتصال به سامانه، ثبت‌نام سامانه مودیان از صفر تا صد را بخوانید و برای پیام‌های خطا به راهنمای رفع خطا سر بزنید.