SSD Nodes Learn Hosting plans →
নির্দেশিকা Matt Connorদ্বারা Matt Connor · আপডেট করা হয়েছে 2026-10-23

Self-hosted সফটওয়্যারে SSO tax কেন নেওয়া হয়?

Self-hosted সফটওয়্যারে OIDC ও SAML ব্যবহারের জন্য কেন অর্থ দিতে হয় তা জানুন। SSO tax-এর পেছনের কারণ এবং কোনো টুল ইনস্টল করার আগে যাচাই করার প্রয়োজনীয় চেকলিস্ট এখানে দেওয়া হলো।

SSO tax কী

Self-hosted সফটওয়্যারের ক্ষেত্রে SSO tax হলো এমন একটি রীতি যেখানে অ্যাপ্লিকেশনটি বিনামূল্যে ব্যবহার করা গেলেও Single Sign-On (SSO) ফিচারটি ব্যবহারের জন্য অর্থ প্রদান করতে হয়। আপনি কোনো লাইসেন্স কি (licence key) বা সিট কাউন্ট (seat count) ছাড়াই নিজের VPS-এ পুরো সিস্টেমটি চালাতে পারেন। কিন্তু এরপর যখন আপনি ডকুমেন্টেশনে গিয়ে অথেন্টিকেশন পেজটি খোলেন, তখন দেখেন যে OpenID Connect (OIDC) বা SAML (security assertion markup language) ফিচারগুলো পেইড প্ল্যানের অন্তর্ভুক্ত।

এটি সাধারণ কোনো ফিচার পেওয়ালের চেয়েও বেশি গুরুত্বপূর্ণ, কারণ SSO-ই হলো সেই প্রযুক্তি যা একাধিক self-hosted সার্ভিসকে একটি একক সিস্টেমের মতো কাজ করতে সাহায্য করে। একটি Identity Provider (IdP) আপনাকে প্রতি ব্যক্তির জন্য একটি অ্যাকাউন্ট, একটি পাসওয়ার্ড পলিসি, মাল্টি-ফ্যাক্টর অথেন্টিকেশন (MFA) চালু করার একটি জায়গা এবং কাউকে সিস্টেম থেকে বাদ দেওয়ার একটি কেন্দ্রীয় নিয়ন্ত্রণ ব্যবস্থা প্রদান করে। এটি ছাড়া, প্রতিটি অ্যাপ নিজস্ব ছোট ইউজার ডাটাবেস বজায় রাখে এবং আপনাকে প্রতিটি ডাটাবেস আলাদাভাবে হাতে পরিচালনা করতে হয়।

এই রীতিটি এত পুরনো যে এর একটি পাবলিক স্কোরবোর্ডও রয়েছে। sso.tax-এ থাকা SSO Wall of Shame-এ এমন সব ভেন্ডরদের তালিকা দেওয়া আছে যারা Single Sign-On-এর জন্য অতিরিক্ত প্রিমিয়াম চার্জ করে। এই তালিকার এন্ট্রিগুলো 2018 সাল থেকে চলে আসছে এবং এর লেখক একটি যৌক্তিক মানদণ্ড নির্ধারণ করেছেন: "যদি আপনার SSO সাপোর্টের জন্য মূল মূল্যের ওপর 10% দাম বাড়ানো হয়, তবে আপনি এই তালিকায় নেই।" এই তালিকার বেশিরভাগই ক্লোজড সোর্স সফটওয়্যার। এখন একই ধরনের প্রাইসিং লজিক ওপেন সোর্স প্রজেক্টগুলোতেও দেখা যাচ্ছে, যা আপনি নিজেই হোস্ট করছেন।

কেন মেইনটেইনাররা সিঙ্গেল সাইন-অন (SSO)-কে পেইড টায়ারের অন্তর্ভুক্ত করেন

এর দুটি কারণ রয়েছে এবং উভয়ই যৌক্তিক। SSO সাপোর্ট করা ব্যয়বহুল এবং এটি এমন কয়েকটি ফিচারের মধ্যে একটি যার জন্য বড় প্রতিষ্ঠানগুলো অর্থ প্রদান করতে রাজি থাকে।

সাপোর্ট খরচটি বাস্তব কারণ একটি আইডেন্টিটি ইন্টিগ্রেশন কখনোই পুরোপুরি শেষ হয় না। প্রতিটি IdP তাদের ক্লেইমগুলো কিছুটা ভিন্নভাবে ফরম্যাট করে। গ্রুপ ম্যাপিং, সেশন লাইফটাইম, রিডাইরেক্ট URL এবং ক্লক স্কিউ—এগুলোর প্রতিটিই লগইন সংক্রান্ত ত্রুটি তৈরি করতে পারে। আর একটি লগইন ত্রুটি মানেই সব ব্যবহারকারী একসাথে লক আউট হয়ে যাওয়া, তাই এই টিকিটগুলো অত্যন্ত জরুরি ভিত্তিতে সমাধান করতে হয়। এরপর আসে পরবর্তী অনুরোধগুলো: নেস্টেড গ্রুপ, রোল ম্যাপিং, SCIM (system for cross-domain identity management)-এর মাধ্যমে স্বয়ংক্রিয় প্রোভিশনিং এবং অডিট লগ যা কমপ্লায়েন্স টিম যাচাই করে।

রাজস্বের দিকটি বিদ্বেষ নয়, বরং গাণিতিক হিসাব। যে কোম্পানি তাদের নিজস্ব IdP-এর সাথে অ্যাপটিকে কানেক্ট করতে পারে না, তারা সেটি ব্যবহারই করবে না। তাই SSO পেইড ব্যবহারকারী এবং ফ্রি ব্যবহারকারীর মধ্যে একটি স্পষ্ট বিভাজন রেখা তৈরি করে। একটি ওপেন কোর প্রজেক্টকে এই রেখাটি কোথাও না কোথাও টানতে হয়। অন্য যেকোনো ফিচারের তুলনায় SSO এই রেখাটিতে সবচেয়ে ভালোভাবে খাপ খায়, আর একারণেই অনেক প্রজেক্ট এটি বেছে নেয়।

সাধারণ অভিযোগের বিপরীতে একটি সংশোধন: কোনো ফিচার সরিয়ে ফেলা হয়েছে বলে ধরে নেওয়ার আগে changelog চেক করুন, কারণ কোনো কিছু সরিয়ে ফেলা হলে তা release notes-এ উল্লেখ থাকে। এই পোস্টের জন্য আমি যেসব প্রজেক্ট যাচাই করেছি, তার বেশিরভাগ ক্ষেত্রেই পেইড SSO ফিচারগুলো শুরু থেকেই পেইড টায়ারের জন্য তৈরি করা হয়েছিল। Planka এক্ষেত্রে ব্যতিক্রম। এর ফ্রি Community edition-এ 9 আগস্ট 2026-এ রিলিজ হওয়া 2.2.0 ভার্সন পর্যন্ত OIDC কাজ করত, যার release notes-এ বলা হয়েছে "OIDC/SSO has been removed from PLANKA Community." ফিচারটি এখন Planka Pro-তে রয়েছে এবং মেইনটেইনারদের নিজস্ব ব্যাখ্যায় বিষয়টি স্বীকার করা হয়েছে: "The fact that it ended up in Community never fit that model." Grafana বাকিদের মতোই সাধারণ। এর SAML পেজে এক লাইনের একটি নোট আছে, "Available in Grafana Enterprise and Grafana Cloud", যেখানে আপনার নিজস্ব ইস্যুয়ারে জেনেরিক OAuth ওপেন সোর্স বিল্ডেও কাজ করে।

SSO ট্যাক্স আসলে আপনার কত খরচ করায়

টাকার অংকটা ক্ষতির ছোট অংশ। বেশিরভাগ পেইড টায়ার প্রতি ব্যবহারকারীর ভিত্তিতে বিক্রি করা হয়, তাই আপনার টিমের আকার বাড়ার সাথে সাথে বিলও বাড়তে থাকে, অথচ হোস্টিং এবং আপগ্রেডের দায়িত্ব আপনারই থেকে যায়। n8n একটি ব্যতিক্রম: তাদের প্রাইসিং পেজ অনুযায়ী সব প্ল্যানেই আনলিমিটেড ব্যবহারকারী থাকে এবং তারা এর পরিবর্তে মাসিক ওয়ার্কফ্লো এক্সিকিউশনের ওপর ভিত্তি করে চার্জ করে।

এর বড় খরচটি হলো ম্যানুয়াল আইডেন্টিটি ম্যানেজমেন্টের কাজ, যা চারটি ক্ষেত্রে প্রভাব ফেলে।

  • প্রতিটি অ্যাপের জন্য আলাদা পাসওয়ার্ড স্টোর থাকে, তাই একটি পাসওয়ার্ড পুনরায় ব্যবহার করলে তা সেই পাসওয়ার্ড শেয়ার করা প্রতিটি অ্যাপের জন্য একটি নিরাপত্তা ঝুঁকি তৈরি করে।
  • স্মৃতি থেকে অফবোর্ডিং করা। একজন ব্যক্তি কোন কোন সার্ভিসে কাজ করেছেন তা আপনাকে মনে রাখতে হয়, আর যেটির কথা আপনি ভুলে যাবেন সেটিই সবচেয়ে গুরুত্বপূর্ণ হয়ে দাঁড়ায়।
  • প্রতিটি অ্যাপের জন্য আলাদাভাবে MFA কনফিগার করা, যদি অ্যাপটি তা সাপোর্ট করে।
  • শেয়ারড লগইন, যা এই চাপের মুখে ছোট টিমগুলোতে বাস্তবে ঘটে থাকে।

শেষ পয়েন্টটি আলাদাভাবে আলোচনার দাবি রাখে। যখন একটি টিমের সবাই ডকুমেন্ট ম্যানেজারের একটি অ্যাডমিনিস্ট্রেটর অ্যাকাউন্ট শেয়ার করে, তখন অডিট ট্রেইলে সবকিছুর জন্য একটি নামই রেকর্ড হয়। ফলে কে ইনভয়েস ডিলিট করেছে তা আপনি বুঝতে পারবেন না। ব্যবহারকারী-ভিত্তিক পারমিশনও তখন কাজ করা বন্ধ করে দেয়, কারণ সেখানে মাত্র একজন ব্যবহারকারী থাকে। SSO ট্যাক্সের আসল ক্ষতি এখানেই: এটি ছোট টিমগুলোকে একটি শেয়ারড অ্যাকাউন্টের দিকে ঠেলে দেয়, যা অন্য যেকোনো বিকল্পের চেয়ে বেশি ঝুঁকিপূর্ণ।

যেকোনো কিছু গ্রহণ করার আগে যে চেকলিস্ট অনুসরণ করবেন

অ্যাপটিতে 400টি ডকুমেন্ট জমা হওয়ার পরে নয়, বরং docker compose up-এর আগেই এটি রান করুন।

  1. ডকুমেন্টেশনের অথেন্টিকেশন পেজটি খুলুন এবং একদম উপরে থাকা টিয়ার নোটটি পড়ুন। পেইড ফিচারগুলোতে একটি ব্যাজ বা এক লাইনের প্রাপ্যতা সংক্রান্ত বাক্য থাকে।
  2. অ্যাপটি নির্দিষ্ট কিছু পাবলিক প্রোভাইডারের তালিকার পরিবর্তে আপনার নিজস্ব ইস্যুয়্যারের সাথে OIDC বা SAML প্রোটোকলে কথা বলতে পারে কি না তা নিশ্চিত করুন।
  3. রোল এবং গ্রুপ ম্যাপিং চেক করুন। ইউজার তৈরি করা কাজের অর্ধেক; দশটি অ্যাপে হাতে কলমে পারমিশন অ্যাসাইন করা বাকি অর্ধেক কাজ যা বেশ কষ্টসাধ্য।
  4. অ্যাপটি কোনো ট্রাস্টেড প্রক্সি থেকে হেডার হিসেবে অথেন্টিকেটেড ইউজারনেম গ্রহণ করে কি না এবং আপনি কোন প্রক্সিকে ট্রাস্ট করবেন তা নির্দিষ্ট করা যায় কি না, তা যাচাই করুন।
  5. গিট (git)-এ লাইসেন্স হিস্ট্রি পড়ুন এবং কন্ট্রিবিউটররা CLA (contributor licence agreement) স্বাক্ষর করে কি না তা চেক করুন।
  6. অফবোর্ডিং প্রক্রিয়া চেক করুন। IdP অ্যাকাউন্ট ডিজেবল করা হলে API (application programming interface) টোকেন এবং লাইভ সেশনগুলোর কী হয় তা খুঁজে বের করুন।

2 নম্বর পয়েন্টেই বেশিরভাগ ক্ষেত্রে হতাশা তৈরি হয়। একটি "Sign in with Google" বাটন মানেই আপনার আইডেন্টিটি প্রোভাইডারের সাথে OIDC নয়: এটি একটি নির্দিষ্ট ভেন্ডরের সাথে ফিক্সড ইন্টিগ্রেশন। প্রকৃত সাপোর্টে আপনার কাছে একটি ইস্যুয়্যার URL চাওয়া হবে এবং বাকি সবকিছু ডিসকভারি থেকে আসবে। আপনি একটি কমান্ডের মাধ্যমেই আপনার প্রোভাইডারের দিক থেকে তা নিশ্চিত করতে পারেন।

curl -s https://id.example.com/.well-known/openid-configuration \
  | jq '.issuer, .authorization_endpoint, .token_endpoint'

একটি সঠিক প্রোভাইডারের কাছ থেকে তিনটি URL ফিরে আসে। খালি রেজাল্ট বা 404 মানে সাধারণত ডিসকভারি পাথ ভুল, এবং সেই পাথটি প্রোভাইডার অনুযায়ী ভিন্ন হয়: Keycloak এটি /realms/<realm>/.well-known/openid-configuration-এর অধীনে পাবলিশ করে। যদি অ্যাপটিতে ইস্যুয়্যার URL-এর জন্য কোনো ফিল্ড না থাকে, তবে ফিচারের তালিকায় যাই লেখা থাকুক না কেন, এটি আপনার IdP-এর সাথে যোগাযোগ করতে পারবে না।

6 নম্বর পয়েন্টটি কেউ চলে যাওয়ার কয়েক সপ্তাহ পর সমস্যা তৈরি করে। IdP-তে অ্যাকাউন্ট ডিজেবল করলে নতুন লগইন বন্ধ হয়। কিন্তু এটি অ্যাপের আগে ইস্যু করা কোনো API টোকেন বাতিল করে না, কারণ অ্যাপটি নিজেই সেই টোকেন ভ্যালিডেট করে এবং IdP-কে এ বিষয়ে কিছুই জিজ্ঞেস করে না। তাই অফবোর্ডিংয়ের দুটি ধাপ রয়েছে: প্রথমে IdP-তে অ্যাকাউন্ট ডিজেবল করুন, তারপর প্রতিটি অ্যাপের ভেতর থেকে ইউজার বা তার টোকেনগুলো ডিলিট করুন।

টিয়ার ব্যাজগুলো আসলে কী নির্দেশ করে

11 অক্টোবর 2026 তারিখে প্রতিটি প্রজেক্টের নিজস্ব ডকুমেন্টেশন যাচাই করে এই তথ্যগুলো নেওয়া হয়েছে। পেইড বা অর্থপ্রদত্ত সংস্করণ দিয়ে শুরু করা যাক।

Grafana তাদের SAML-কে "Available in Grafana Enterprise and Grafana Cloud" হিসেবে উল্লেখ করে, যার সাথে টিম সিঙ্ক এবং SCIM প্রোভিশনিং অন্তর্ভুক্ত। জেনেরিক OAuth, GitHub OAuth, LDAP (lightweight directory access protocol) এবং auth proxy ওপেন সোর্স বিল্ডেই থাকে, তাই ছোট পরিসরে যারা self-host করেন তারা তাদের নিজস্ব প্রোভাইডারের মাধ্যমে লগইন করতে পারেন। পেইড ফিচারের সীমাটি SAML-এ এসে পড়ে, পুরো single sign-on-এ নয়; "SSO tax" কথাটি এই সূক্ষ্ম পার্থক্যটিকে এড়িয়ে যায়।

Metabase-এর অবস্থান আরও স্পষ্ট। তাদের ডকুমেন্টেশনে বলা হয়েছে, "SAML authentication is only available on Pro and Enterprise plans (both self-hosted and on Metabase Cloud)." ওপেন সোর্স সংস্করণে শুধু পাসওয়ার্ড লগইন এবং LDAP সুবিধা রয়েছে।

Passbolt তাদের SSO ডকুমেন্টেশনে Pro এবং Cloud-এর উল্লেখ রেখেছে, তাই কমিউনিটি সংস্করণে এটি নেই। তাদের সমর্থিত প্রোভাইডারগুলোর মধ্যে Keycloak এবং Entra ID অন্তর্ভুক্ত।

n8n-এর ক্ষেত্রে সবকিছুই একটি নির্দিষ্ট ফি-এর পেছনে সীমাবদ্ধ। self-hosted কমিউনিটি সংস্করণটি fair-code লাইসেন্সের অধীনে বিনামূল্যে পাওয়া যায়, কিন্তু ডকুমেন্টেশন অনুযায়ী SAML এবং LDAP লগইন Business এবং Enterprise প্ল্যানে এবং OIDC শুধুমাত্র Enterprise প্ল্যানে পাওয়া যায়। অর্থাৎ, এখানে বিনামূল্যে single sign-on ব্যবহারের কোনো সুযোগ নেই। এটি ফ্রি n8n সংস্করণে যা যা নেই তার দীর্ঘ তালিকার একটি অংশ।

এবার অন্য দিকটি দেখা যাক, কারণ এই প্যাটার্নটি সব ক্ষেত্রে প্রযোজ্য নয়।

  • GitLab Self-Managed-এর SAML পৃষ্ঠায় "Tier: Free, Premium, Ultimate" উল্লেখ আছে, তাই নিজস্ব GitLab-এ SAML ব্যবহার করতে কোনো খরচ লাগে না।
  • Paperless-ngx-এ PAPERLESS_SOCIALACCOUNT_PROVIDERS ব্যবহার করে OIDC কনফিগার করা যায়, PAPERLESS_DISABLE_REGULAR_LOGIN দিয়ে লোকাল লগইন ফর্ম লুকানো যায় এবং PAPERLESS_SOCIAL_ACCOUNT_SYNC_GROUPS দিয়ে ক্লেইমগুলোকে গ্রুপে ম্যাপ করা যায়।
  • Planka এখন আর এই তালিকায় নেই। এর কমিউনিটি সংস্করণে OIDC_ISSUER, OIDC_CLIENT_ID এবং OIDC_CLIENT_SECRET ছিল, openid profile email-এ স্কোপ ডিফল্ট করা ছিল এবং OIDC_ADMIN_ROLES ব্যবহার করে রোল ক্লেইম থেকে অ্যাডমিনিস্ট্রেটর তৈরি করা যেত। কিন্তু 9 আগস্ট 2026-এ 2.2.0 ভার্সন আসার পর কমিউনিটি সংস্করণ থেকে OIDC সরিয়ে Planka Pro-তে নিয়ে যাওয়া হয়েছে। পুরনো কমিউনিটি রিলিজগুলোতে এটি থাকলেও, মেইনটেইনাররা শুধুমাত্র সর্বশেষ রিলিজটিই সাপোর্ট করেন।
  • BookStack AUTH_METHOD=oidc দিয়ে সুইচ করে, তারপর OIDC_USER_TO_GROUPS=true এবং OIDC_GROUPS_CLAIM ব্যবহার করে প্রোভাইডার গ্রুপগুলোকে নিজস্ব রোলের সাথে ম্যাপ করে।
  • Vaultwarden 27 ডিসেম্বর 2025-এ 1.35.0 ভার্সনে "support for SSO with OpenID Connect" যুক্ত করেছে, যা একজন কন্ট্রিবিউটরের পুল রিকোয়েস্ট থেকে এসেছে, যিনি আগে এটি একটি ফোর্ক হিসেবে বজায় রেখেছিলেন।
  • listmonk-এ 12 নভেম্বর 2024-এ মুক্তি পাওয়া v4.1.0 ভার্সন থেকে ইউজার রোলের পাশাপাশি OIDC লগইন সুবিধা রয়েছে।

কোনো প্রজেক্টে কাজ শুরু করার আগেই এই বিষয়গুলো বিবেচনা করুন। একটি Planka kanban board এবং অন্যান্য self-hosted Trello বিকল্পগুলো একইভাবে আইডেন্টিটি ম্যানেজমেন্ট হ্যান্ডেল করে না, যেমনটা করে না BookStack, Wiki.js এবং Outline। ফ্রি OIDC একটি ফিচার যা আপনি স্টোরেজ লিমিট বা মোবাইল ক্লায়েন্টের মতোই গুরুত্ব দিয়ে বিবেচনা করতে পারেন। আপনি যদি এখনো তালিকা তৈরি করে থাকেন, তবে 2026 সালে যা যা self-host করা যায় একটি ভালো শুরুর পয়েন্ট হতে পারে, এবং Paperless-ngx ডকুমেন্ট ম্যানেজার ও Vaultwarden উভয়ই আপনাকে বর্তমানে বিনামূল্যে OIDC ব্যবহারের সুবিধা দিচ্ছে।

কেন অ্যাপের সামনে থাকা reverse proxy-কে single sign-on বলা যায় না

এর সাধারণ সমাধান হলো forward auth। আপনার reverse proxy প্রতিটি অনুরোধ আটকে রাখে, একটি authentication service-কে জিজ্ঞাসা করে যে এই browser-টি লগ-ইন করা আছে কি না, এবং কেবল তখনই অনুরোধটি অ্যাপের কাছে পাঠায়। authentik একে proxy provider বলে, যার একটি forward auth মোড একক অ্যাপ্লিকেশনের জন্য এবং অন্যটি পুরো ডোমেইনের জন্য কাজ করে। Authelia এবং oauth2-proxy একই কাজ করে।

authentik-এর নিজস্ব উদাহরণ অনুসরণ করে একটি Caddy site block দেখতে এমন হয়।

app.example.com {
  forward_auth http://authentik-outpost:9000 {
    uri /outpost.goauthentik.io/auth/caddy
    copy_headers X-Authentik-Username X-Authentik-Email X-Authentik-Groups
    trusted_proxies private_ranges
  }
  reverse_proxy app:8000
}

Caddy-তে header-এর নামগুলোর ক্ষেত্রে বড় হাতের বা ছোট হাতের অক্ষর (capitalisation) গুরুত্বপূর্ণ, কারণ নামের মিল না থাকলে তা খালি হিসেবে পৌঁছায়। অনুমোদিত প্রতিটি অনুরোধে, outpost X-authentik-username, X-authentik-email, X-authentik-groups এবং আরও কিছু header সেট করে।

এটি আপনাকে যা দেয়: আপনার identity provider পার না হয়ে কেউ অ্যাপে পৌঁছাতে পারে না, তাই একটি unpatched login form আর ইন্টারনেটে উন্মুক্ত থাকে না এবং proxy-র পেছনের সবকিছুর ওপর MFA কার্যকর হয়।

এটি আপনাকে যা দেয় না: অ্যাপের ভেতরে identity। অ্যাপের নিজস্ব অ্যাকাউন্ট এবং কে লগ-ইন করা আছে সে সম্পর্কে নিজস্ব ধারণা থাকে। যদি সবাই proxy পার হয়ে একটি সাধারণ administrator অ্যাকাউন্টে পৌঁছায়, তবে আপনার সামনে একটি শক্তিশালী দরজা থাকলেও পেছনে একটি বেনামী session থেকে যায়। audit log-এ কেবল একটি নামই দেখা যায়। মানুষের মধ্যে অনুমতির পার্থক্য করা যায় না। এই ব্যবস্থাকে SSO বলা একটি নিরাপত্তা সংক্রান্ত ভুল, কারণ offboarding-এর বিষয়টি কেবল অর্ধেক সত্য: আপনার IdP থেকে ব্যক্তিকে সরিয়ে দিলে সামনের দরজা বন্ধ হয়ে যায়, কিন্তু অ্যাপের ভেতরে তাদের তৈরি করা API token যে কেউ সরাসরি অ্যাপে পৌঁছাতে পারলে কাজ করতে থাকে।

হেডার অথেন্টিকেশন নিরাপদ করা

কিছু অ্যাপ প্রক্সির কাছ থেকে ইউজারনেম গ্রহণ করে, যা আপনাকে পেইড SSO ছাড়াই প্রতি-ব্যবহারকারী পরিচিতি ব্যবহারের সুবিধা দেয়। প্রতিটি প্রজেক্টে এই সেটিংটির নাম ভিন্ন হয়।

Grafana একে auth proxy বলে এবং এটি ডিফল্টভাবে নিষ্ক্রিয় থাকে। হেডারটির নাম ডিফল্টভাবে X-WEBAUTH-USER থাকে এবং আপনি আপনার প্রক্সিতে যে হেডার সেট করেছেন, সেটির দিকে একে নির্দেশ করতে পারেন।

[auth.proxy]
enabled = true
header_name = X-authentik-username
header_property = username
auto_sign_up = true
whitelist = 10.0.0.5

whitelist হলো সেই লাইন যা মানুষ এড়িয়ে যায়। Grafana-এর ডকুমেন্টেশনে স্পষ্টভাবে বলা আছে যে, ব্যবহারকারীরা যাতে হেডার স্পুফিং (spoofing) করতে না পারে সেজন্যই এটি রাখা হয়েছে। তাই এতে শুধুমাত্র আপনার প্রক্সির অ্যাড্রেস থাকা উচিত, অন্য কিছু নয়। Gitea-তেও একই ফিচার ভিন্ন নামে রয়েছে এবং এটি আরও নিরাপদ ডিফল্ট সেটিংস নিয়ে আসে।

[security]
ENABLE_REVERSE_PROXY_AUTHENTICATION = true
REVERSE_PROXY_AUTHENTICATION_USER = X-WEBAUTH-USER
REVERSE_PROXY_TRUSTED_PROXIES = 10.0.0.5/32
REVERSE_PROXY_LIMIT = 1

REVERSE_PROXY_TRUSTED_PROXIES ডিফল্টভাবে 127.0.0.0/8,::1/128 থাকে এবং REVERSE_PROXY_LIMIT হলো প্রক্সির চেইনে Gitea কতগুলো প্রক্সিকে বিশ্বাস করবে তার সংখ্যা। এই লিমিট শূন্য সেট করলে হেডার হ্যান্ডলিং পুরোপুরি বন্ধ হয়ে যায়।

Paperless-ngx-এ PAPERLESS_ENABLE_HTTP_REMOTE_USER এবং PAPERLESS_HTTP_REMOTE_USER_HEADER_NAME রয়েছে, এবং এর ডকুমেন্টেশনে এই ধরনের সব সেটিংসের জন্য একটি সতর্কবার্তা দেওয়া আছে:

এটি রিকোয়েস্টের সাথে একটি Remote-User: <username> হেডার যোগ করে অথেন্টিকেশনের অনুমতি দেয়। সতর্কতার সাথে ব্যবহার করুন!

হেডার অথেন্টিকেশন নিরাপদ রাখতে দুটি নিয়ম মেনে চলতে হয় এবং উভয়ই রিচেবিলিটি (reachability) বা সংযোগযোগ্যতার সাথে সম্পর্কিত। প্রথমত, অ্যাপটিকে অবশ্যই প্রক্সি ছাড়া অন্য কোনোভাবে অ্যাক্সেস করা যাবে না, কারণ যে কেউ অ্যাপটির সাথে সকেট সংযোগ স্থাপন করতে পারলে সে হেডার পাঠিয়ে যেকোনো ব্যবহারকারী হিসেবে লগইন করতে পারবে। Docker-এ, ports: ["8000:8000"] প্রতিটি ইন্টারফেসে পাবলিশ হয়, তাই একে ports: ["127.0.0.1:8000:8000"] ব্যবহার করে লুপব্যাক অ্যাড্রেসে বাইন্ড করুন অথবা পাবলিশ করা পোর্টটি সরিয়ে প্রক্সিকে একই Docker নেটওয়ার্কে রাখুন। দ্বিতীয়ত, প্রক্সিকে অবশ্যই ক্লায়েন্টের কাছ থেকে আসা হেডারের যেকোনো কপি মুছে ফেলতে হবে, যাতে অ্যাপটি শুধুমাত্র সেই মানটিই দেখতে পায় যা আপনার প্রক্সি অথেন্টিকেশনের পর সেট করেছে।

উভয়ই পরীক্ষা করুন। প্রথম কমান্ডটি আপনার VPS-এর বাইরের একটি মেশিন থেকে এবং দ্বিতীয়টি সরাসরি সার্ভারে চালান।

curl -si -H "Remote-User: admin" http://203.0.113.10:8000/ | head -n 1
ss -ltnp | grep 8000

curl কমান্ডটি কানেক্ট করতে ব্যর্থ হওয়া উচিত এবং ss-এর আউটপুট 0.0.0.0:8000-এর পরিবর্তে 127.0.0.1:8000 দেখানো উচিত। যেকোনো স্ট্যাটাস লাইন, যেমন HTTP/1.1 302 Found (একটি রিডাইরেক্ট, সাধারণত লগইন পেজে), মানে হলো অ্যাপটি সরাসরি পাবলিক ইন্টারনেটের প্রশ্নের উত্তর দিচ্ছে। হেডার অথেন্টিকেশন চালু থাকা অবস্থায় এটি এমন একটি ঝুঁকি, যা যে কাউকে হেডারে নাম উল্লেখ করে যেকোনো ব্যবহারকারী হিসেবে লগইন করার সুযোগ করে দেয়।

যখন কোনো ফ্রি SSO নেই, তখন অভিযোগ না করে সিদ্ধান্ত নিন

আমি যে ক্রমানুসারে চেষ্টা করব, সেই অনুযায়ী চারটি বিকল্প নিচে দেওয়া হলো।

  1. OIDC সমর্থন করে এমন অ্যাপ বেছে নিন। যখন দুটি প্রজেক্ট একই কাজ করে কিন্তু একটি আপনার identity provider-এর সাথে বিনামূল্যে কাজ করতে পারে, তখন সেটি পরিচালন ব্যয়ের ক্ষেত্রে বড় পার্থক্য তৈরি করে।
  2. সততার সাথে forward auth ব্যবহার করুন। একজন ব্যবহারকারী এবং একজন অপারেটর আছে এমন অ্যাডমিন টুলের ক্ষেত্রে, সামনে একটি proxy থাকাই যথেষ্ট। অ্যাপের ভেতরে প্রতি ব্যবহারকারীর জন্য আলাদা identity-র কোনো বাড়তি সুবিধা নেই।
  3. অর্থ প্রদান করুন। যদি অ্যাপটি আপনার কাজের জন্য কেন্দ্রীয় ভূমিকা পালন করে এবং জনপ্রতি মূল্য আপনার দলের আকারের সাথে সামঞ্জস্যপূর্ণ হয়, তবে এই অর্থ প্রজেক্টটিকে সচল রাখে। অন্যথায়, আপনাকে আপনার ব্যক্তিগত সময় ব্যয় করে এটি সামলাতে হবে।
  4. issue tracker-এ খোঁজার পর upstream-এর কাছে অনুরোধ জানান। Vaultwarden-এর OIDC সমর্থন একজন কন্ট্রিবিউটরের fork এবং দীর্ঘস্থায়ী pull request-এর মাধ্যমে এসেছে। তাই কার্যকর ইমপ্লিমেন্টেশনসহ ফিচার রিকোয়েস্ট অনেক সময় ফ্রি সংস্করণে যুক্ত হয়।

আপনার নিজস্ব identity provider ছাড়া এর কোনোটিই কাজ করবে না, তাই এটিই সবার আগে তৈরি করতে হবে। VPS-এ authentik চালানো আপনাকে একটি OIDC এবং SAML প্রোভাইডার দেবে, সেই সাথে উপরে উল্লিখিত forward auth outpost-ও পাওয়া যাবে। আর আপনি যদি এখনই কোনোটিতে প্রতিশ্রুতিবদ্ধ হতে না চান, তবে Keycloak, authentik এবং Zitadel-এর তুলনা আপনাকে সিদ্ধান্ত নিতে সাহায্য করবে।

লাইসেন্সের ইতিহাস এবং কেন এটি চেকলিস্টে রাখা হয়েছে

চেকলিস্টের শেষ আইটেমটি ভবিষ্যৎ নিয়ে, কারণ আজকের টায়ার লেআউট কেবল একটি নির্দিষ্ট সময়ের চিত্র মাত্র। দুটি সুপ্রমাণিত ঘটনা দেখায় যে পরিস্থিতি কত দ্রুত পরিবর্তিত হতে পারে। 10 আগস্ট 2023-এ HashiCorp তাদের সমস্ত পণ্যের ভবিষ্যৎ রিলিজ এবং বেশ কিছু লাইব্রেরিকে MPL 2.0 (Mozilla Public License) থেকে Business Source License 1.1-এ স্থানান্তর করে, যদিও তাদের API, SDK এবং অন্য প্রায় সব লাইব্রেরি MPL 2.0-এর অধীনেই থেকে যায়। Redis মার্চ 2024-এ SSPL (Server Side Public License)-এ চলে যায় এবং পরবর্তীতে 1 মে 2025-এ ঘোষণা করে যে Redis 8 এখন AGPLv3 (GNU Affero General Public License)-এর অধীনে রিলিজ হবে।

এই ঘটনাগুলোকে উদ্দেশ্যের চেয়ে বরং কার্যপদ্ধতির প্রমাণ হিসেবে দেখুন। আপনি আজ যে লাইসেন্সটি পড়ছেন তা কেবল আজকের ইনস্টল করা ভার্সনের জন্য প্রযোজ্য, এবং যে প্রজেক্টের সমস্ত কপিরাইট তাদের নিজেদের হাতে থাকে, তারা পরবর্তী রিলিজের শর্তাবলী এককভাবে পরিবর্তন করতে পারে। এই কারণেই CLA সংক্রান্ত প্রশ্নটি চেকলিস্টে রাখা হয়েছে, কারণ ব্যাপক কপিরাইট অ্যাসাইনমেন্টই একতরফাভাবে লাইসেন্স পরিবর্তনের সুযোগ তৈরি করে।

কোনো প্রজেক্টের ওপর ভিত্তি করে কাজ শুরু করার আগে সেটির ইতিহাস নিজে যাচাই করে নিন।

git clone --filter=blob:none https://github.com/paperless-ngx/paperless-ngx.git
cd paperless-ngx
git log --follow --oneline -- LICENSE

কমিটগুলোর একটি সংক্ষিপ্ত তালিকা, বিশেষ করে প্রথম ইমপোর্টের সময়কার কমিটগুলো, একটি ভালো লক্ষণ। লাইসেন্স ফাইলটি বারবার পরিবর্তন করা হয়েছে এমনটি দেখলে, বর্তমান শর্তাবলীর ওপর নির্ভর করার আগে প্রতিটি কমিট মেসেজ সতর্কতার সাথে পড়ে নেওয়া উচিত।

FAQ

SSO tax কী?

SSO tax হলো এমন একটি চর্চা যেখানে পণ্যের মূল অংশ বিনামূল্যে বা কম খরচে দেওয়া হলেও Single Sign-on (SSO) ফিচারের জন্য অতিরিক্ত মূল্য নেওয়া হয়। self-hosted সফটওয়্যারের ক্ষেত্রে এটি এমন একটি ওপেন সোর্স অ্যাপ্লিকেশনের মতো, যা আপনি লাইসেন্স কি ছাড়াই চালাতে পারেন, কিন্তু OIDC বা SAML লগইন ব্যবহারের জন্য আপনাকে পেইড টায়ারে যেতে হয়। এই নামটি এসেছে sso.tax-এর 'SSO Wall of Shame' থেকে, যা সেইসব ভেন্ডরদের তালিকাভুক্ত করে যারা এর জন্য বড় অংকের প্রিমিয়াম চার্জ করে। একজন self-hoster-এর জন্য এর ফলাফল হলো, প্রতিটি অ্যাপের নিজস্ব ইউজার ডাটাবেস থাকে, ফলে অ্যাকাউন্টগুলো হাতে তৈরি এবং মুছে ফেলতে হয়।

Forward auth সহ একটি reverse proxy কি SSO-এর সমান?

না। Forward auth শুধুমাত্র সামনের দরজা বা ফ্রন্ট ডোর সুরক্ষিত রাখে: কোনো অনুরোধ অ্যাপে পৌঁছানোর আগেই আপনার প্রক্সি identity provider-এর সাথে যাচাই করে নেয়। এর পেছনের অ্যাপটি তখনও তার নিজস্ব অ্যাকাউন্ট ব্যবহার করে, তাই সবাই যদি একটি শেয়ারড লগইনে প্রবেশ করে, তবে আপনি একটি একক anonymous session পাবেন এবং অডিট লগে কেবল একটি নামই দেখা যাবে। এটি তখনই প্রকৃত per-user identity হয়ে ওঠে যখন অ্যাপটি কোনো হেডার থেকে ইউজারনেম পড়ে নিতে পারে, যা Grafana-এর auth proxy, Gitea-এর reverse proxy authentication এবং Paperless-ngx-এর PAPERLESS_ENABLE_HTTP_REMOTE_USER করতে পারে। এই সেটিংসগুলো তখনই নিরাপদ যখন অ্যাপটি প্রক্সি ছাড়া অন্য কোনোভাবে অ্যাক্সেস করা সম্ভব নয়, কারণ হেডারটি একটি সাধারণ স্ট্রিং যা যেকোনো ক্লায়েন্ট পাঠাতে পারে।

কোন self-hosted অ্যাপগুলোর ফ্রি সংস্করণে OIDC অন্তর্ভুক্ত আছে?

11 অক্টোবর 2026 তারিখে প্রজেক্ট ডকুমেন্টেশন অনুযায়ী যাচাই করা হয়েছে: Paperless-ngx, BookStack, Gitea, listmonk এবং Vaultwarden-এর ফ্রি বিল্ডে OIDC সাপোর্ট রয়েছে এবং GitLab Self-Managed-এর Tier: Free-তে SAML অন্তর্ভুক্ত আছে। Planka-তে আগস্ট 2026-এর 2.2.0 ভার্সন পর্যন্ত এটি ছিল, যা পরবর্তীতে OIDC-কে কমিউনিটি এডিশন থেকে সরিয়ে Planka Pro-তে নিয়ে গেছে। Grafana-এর ওপেন সোর্স বিল্ড আপনার নিজস্ব ইস্যুয়্যারের বিপরীতে generic OAuth হ্যান্ডেল করতে পারে, তবে SAML সেখানে একটি এন্টারপ্রাইজ ফিচার। ইনস্টল করার আগে প্রজেক্টের নিজস্ব অথেন্টিকেশন পেজে নিশ্চিত হয়ে নিন, কারণ রিলিজের সাথে সাথে এই তালিকা পরিবর্তিত হতে পারে।

Single sign-on আনলক করার জন্য কি আমার পেইড টায়ারের জন্য অর্থ প্রদান করা উচিত?

দুটি সংখ্যার ভিত্তিতে এটি সিদ্ধান্ত নিন: কতজন মানুষের অ্যাকাউন্টের প্রয়োজন এবং কতগুলো অ্যাপ আপনাকে হাতে মেইনটেইন করতে হতো। একজন বা দুজন অ্যাডমিনিস্ট্রেটরের জন্য লোকাল অ্যাকাউন্টের সামনে forward auth ব্যবহার করাই যথেষ্ট এবং পেইড টায়ার থেকে খুব বেশি সুবিধা পাওয়া যায় না। এমন একটি টিমের জন্য যেখানে মানুষ নিয়মিত যোগ দেয় এবং ছেড়ে যায়, offboarding-এর সময় একটি অ্যাকাউন্ট বাদ পড়ে যাওয়া লাইসেন্স ফি-এর চেয়ে বেশি ব্যয়বহুল হতে পারে এবং আপনার দেওয়া অর্থ সেই মেইনটেন্যান্স ফান্ডে অবদান রাখে যার ওপর আপনি নির্ভর করছেন। যদি দাম আপনার বাজেটের সাথে না মেলে, তবে এমন অ্যাপ বেছে নেওয়াই বুদ্ধিমানের কাজ যাতে OIDC অন্তর্ভুক্ত আছে, এমন অ্যাপের পেছনে সময় নষ্ট না করে যাতে এটি নেই।

এই লেখাটি কি কাজে লেগেছে?