ماژول تراست لاگین
تراست لاگین یک openID است که با یکبار عضویت در آن از طریق هر کدام از سایت ها و یا پنل کاربری بیسیس کور، میتوان با استفاده از نام کاربری ایجاد شده، در سایر سایت های زیرمجموعه بیسیس کور لاگین نمود.
1- ثبت نام
ثبت کاربر جدید در تراست لاگین به دو روش صورت میگیرد:
در روش اول بعد از ایجاد نام کاربری، لازم است از طریق ارسال ایمیل فعالسازی به آدرس ایمیل کاربر، و با کلیک بر روی لینک موجود در آن فعالسازی این کاربر جدید انجام گیرد.
در روش دوم کد لازم برای فعالسازی از طریق sms برای کاربر ارسال خواهد شد و با ثبت آن در سایت ، نام کاربری مورد نظر، فعال میگردد.
برای استفاده از هر کدام از روش ها مراحل زیر را دنبال نمایید:
1-1- ثبت اطلاعات اولیه کاربر جدید (فعالسازی ثبت نام از طریق ایمیل)
این دستور برای ثبت کاربر جدید در تراست لاگین مورد استفاده قرار میگیرد و کاربرد آن در بخش عضویت در سایت میباشد.
خروجی:
خروجی یک رکورد شامل فیلدهای زیر میباشد :
error : این فیلد مشخص کننده آن است که در ثبت کاربر جدید خطایی رخ داده یا خیر. اگر مقدار آن true باشد به این معناست که ثبت با موفقیت انجام شده است. ولی در صورتی که به دلایلی مانند اینکه ایمیل وارد شده تکراری باشد، پسوورد و تکرار آن یکسان نباشد، کد امنیتی وارد نشده و یا نادرست باشد، متن خطای رخ داده ، در این فیلد نمایش داده خواهد شد.
rkey : کد منحصر بفرد تولید شده برای کاربر، که باید در ایمیل فعالسازی فرستاده شود تا وقتی کاربر از طریق ایمیل دریافتی، اقدام به فعال سازی نام کاربری خود مینماید، این کد برای فعالسازی، در دستور بعدی قرا گیرد( این دستور در ادامه توضیح داده خواهد شد) .
url : آدرس صفحه ای که کاربر در زمان ثبت نام در آن قرار داشته است. کاربرد این آدرس برای ریدایرکت صفحه بعد از انجام فرایند ثبت نام خواهد بود. (این فیلد در صورتی مقدار خواهد داشت که در ورودی فیلد referer مقداردهی شده باشد، در غیر اینصورت خالی خواهد بود)
1-2- ثبت اطلاعات اولیه کاربر جدید (فعالسازی ثبت نام از طریق sms)
این دستور برای ثبت کاربر جدید در تراست لاگین مورد استفاده قرار میگیرد و کاربرد آن در بخش عضویت در سایت برای کاربرانی که به ایمیل خود دسترسی ندارند، میباشد.
خروجی:
خروجی یک رکورد شامل فیلدهای زیر میباشد :
error : این فیلد مشخص کننده آن است که در ثبت کاربر جدید خطایی رخ داده یا خیر. اگر مقدار آن true باشد به این معناست که ثبت با موفقیت انجام شده است. ولی در صورتی که به دلایلی مانند اینکه ایمیل وارد شده تکراری باشد، پسوورد و تکرار آن یکسان نباشد، کد امنیتی وارد نشده و یا نادرست باشد، متن خطای رخ داده ، در این فیلد نمایش داده خواهد شد.
rkey : کد منحصر بفرد تولید شده برای کاربر، که باید از طریق sms برای کاربر ارسال شود و کاربر با ثبت آن در سایت، اقدام به فعال سازی نام کاربری خود مینماید، این کد برای فعالسازی، در دستور بعدی قرار گیرد(این دستور در ادامه توضیح داده خواهد شد)
url : آدرس صفحه ای که کاربر در زمان ثبت نام در آن قرار داشته است. کاربرد این آدرس برای ریدایرکت صفحه بعد از انجام فرایند ثبت نام خواهد بود. (این فیلد در صورتی مقدار خواهد داشت که در ورودی فیلد referer مقداردهی شده باشد، در غیر اینصورت خالی خواهد بود)
1-3- فعالسازی نام کاربری
بعد از ثبت اولیه اطلاعات کاربر با هر کدام از دو روش بالا ، لازم است فعالسازی نام کاربر انجام گردد. با ثبت اولیه اطلاعات کاربر در هر کدام از دو روش یک rkey برای کاربر تولید میگردد که تنها تفاوت آن در فرمت آن ها و طول رشته ی تولید شده میباشد. در روش اول باید رشته ی تولید شده را ، از طریق ایمیل برای کاربر ارسال نمود (که یکی از روش های آن ارسال ایمیل با استفاده از دستورات بیسیس کور میباشد). در روش دوم باید رشته ی تولید شده از طریق یک وب سرویس ارسال sms برای کاربر ارسال شود. برای فعالسازی نام کاربری ، باید rkey توسط کاربر (با کلیک بر روی لینک فعالسازی موجود در ایمیل و یا وارد کردن کد sms شده در سایت) در دستور زیر قرار گیرد تا نام کاربر شناسایی شده و نام کاربری او فعال گردد.
خروجی:
خروجی یک رکورد شامل فیلدهای زیر میباشد :
error : در صورتیکه rkey ثبت شده در ورودی های دستور ، صحیح بوده و مربوط به کاربری باشد که نام کاربری آن غیر فعال است، نام کاربری فعال شده و این فیلد مقدار true خواهد داشت. در غیر اینصورت مقدار null خواهد داشت.
rkey : کد منحصر به فردی که از مرحله قبل ارسال شده است در این فیلد نمایش داده می شود.
url : درصورتیکه بخواهیم بعد از فعالسازی ثبت نام به صفحه ای از سایت ریدایرکت شویم، آدرس صفحه را در ورودی referer وارد میکنیم تا در خروجی در این فیلد نمایش داده شود و بتوان از آن برای ریدایرکت کاربر استفاده نمود.
1-4- تکمیل فرآیند ثبت نام
در صورتیکه فعالسازی نام کاربری با موفقیت انجام شده باشد، ثبت اطلاعات تکمیلی کاربر با استفاده از این دستور انجام میگیرد و فرایند ثبت نام کاربر به پایان میرسد.
خروجی:
خروجی این دستور یک فیلد بصورت زیر میباشد :
Column1 : بعد از ثبت اطلاعات مقدار ok برگردانده میشود.
2- ارسال مجدد کد فعالسازی
2-1- ارسال مجددا کد فعالسازی (فعالسازی از طریق ایمیل)
در صورتیکه به هر دلیلی ایمیل فعالسازی بدست کاربر نرسیده باشد، با استفاده از این دستور میتوان مجددا کد فعالسازی را تولید کرده و با استفاده از روش دلخواه برای کاربر ایمیل نمود(یکی از روش های ارسال ایمیل ، استفاده از دستورات basiscore میباشد.)
خروجی:
خروجی یک رکورد شامل فیلدهای زیر میباشد :
error : در صورتیکه ورودی های دستور درست وارد شده باشد، مقدار این فیلد true خواهد بود در غیر اینصورت متن خطای پیش آمده نمایش داده خواهد شد (مانند نادرست بودن کد امنیتی)
rkey : در صورتیکه ورودی ها درست ثبت شده باشند و آدرس ایمیل وارد شده مربوط به کاربری باشد که نام کاربری او غیر فعال است، کد فعالسازی نمایش داده خواهد شد در غیر اینصورت مقدار null خواهد داشت.
url : درصورتیکه بخواهیم بعد از این مرحله به صفحه ای از سایت ریدایرکت شویم، آدرس صفحه را در ورودی referer وارد میکنیم تا در خروجی در این فیلد نمایش داده شود و بتوان از آن برای ریدایرکت کاربر استفاده نمود.
2-2- ارسال مجددا کد فعالسازی (فعالسازی از طریق sms)
در صورتیکه به هر دلیلی sms فعالسازی بدست کاربر نرسیده باشد، با استفاده از این دستور میتوان مجددا کد فعالسازی را تولید کرده و با استفاده از وب سرویس های ارسال sms ، مجددا برای کاربر ارسال نمود.
خروجی:
خروجی یک رکورد شامل فیلدهای زیر میباشد :
error : در صورتیکه ورودی های دستور درست وارد شده باشد، مقدار این فیلد true خواهد بود در غیر اینصورت متن خطای پیش آمده نمایش داده خواهد شد (مانند نادرست بودن کد امنیتی)
rkey : در صورتیکه ورودی ها درست ثبت شده باشند و نام کاربری وارد شده غیر فعال باشد، کد فعالسازی نمایش داده خواهد شد در غیر اینصورت مقدار null خواهد داشت.
url : درصورتیکه بخواهیم بعد از این مرحله به صفحه ای از سایت ریدایرکت شویم، آدرس صفحه را در ورودی referer وارد میکنیم تا در خروجی در این فیلد نمایش داده شود و بتوان از آن برای ریدایرکت کاربر استفاده نمود.
3- ورود به سایت
3-1- ورود به سایت
در صورتیکه کاربری قبلا در تراست لاگین ثبت نام کرده باشد، با استفاده از دستور زیر میتواند در سایت لاگین نماید.
خروجی:
خروجی یک رکورد شامل فیلدهای زیر میباشد :
error : درصورتیکه عملیات ورود به سایت با موفقیت انجام شود، مقدار آن true خواهد بود. در غیر اینصورت متن خطای رخ داده، در این فیلد نمایش داده میشود.
rkey : درصورتیکه عملیات ورود به سایت با موفقیت انجام شود، کد منحصر بفرد تولید شده برای شناسایی کاربر در این فیلد نمایش داده خواهد شد، در غیر اینصورت مقدار null خواهد داشت.
url : این فیلد در صورتی مقدار خواهد داشت که در ورودی فیلد referer مقداردهی شده باشد، در غیر اینصورت خالی خواهد بود. در صورتیکه بخواهیم کاربر بعد از لاگین به صفحه ای منتقل شود که قبل از آن در آنجا قرار داشته است، باید نام صفحه را در ورودی دستور با نام referer ارسال کنیم و در خروجی از آن استفاده کنیم.
3-2- بررسی لاگین بودن یا نبودن کاربر
دستور زیر آی دی کاربر را در سایت فراخوانی میکند. کاربرد این دستور برای بررسی لاگین بود یا نبودن کاربر در سایت میباشد.
خروجی:
خروجی این دستور یک داده واحد بصورت زیر میباشد :
userid : اگر کاربر در سایت وارد شده باشد و rkey کاربر بصورت صحیح در ورودی دستور قرار گرفته باشد، آی دی کاربر در این فیلد نمایش داده میشود، در غیر اینصورت مقدار صفر خواهد داشت.
3-3- لاگین بودن کاربر
در صورتیکه کاربر در سایت لاگین شده باشد، این دستور اطلاعات کاربر را که در مرحله تکمیل فرایند ثبت نام، وارد شده است، فراخوانی میکند.
خروجی:
خروجی این دستور جدولی شامل اطلاعات کاربر می باشد :
prpid : آی دی مشخصه اسکمای اطلاعات کاربران
usedforid : آی دی کاربر
typeid : آی دی نوع مشخصه
multi : فیلد مشخص کننده اینکه این مشخصه در اسکما میتواند بیش از یک پاسخ داشته باشد
question : عنوان مشخصه اسکمای اطلاعات کاربران
answer : پاسخ مشخصه ها
4- فراموشی رمز عبور
4-1- ارسال درخواست تغییر رمز عبور
در صورتیکه کاربر رمز عبور خود را فراموش کرده باشد، با استفاده از این دستور میتواند درخواست تغییر رمز عبور خود را ثبت کند.
خروجی:
خروجی این دستور رکوردی شامل فیلدهای زیر میباشد :
error : در صورتیکه ایمیل وارد شده مربوط به کاربری باشد که قبلا نام کاربری او فعال شده و سایر ورودی ها نیز صحیح باشد، مقدار این فیلد true خواهد بود، در غیر اینصورت خطای موجود در این فیلد نمایش داده خواهد شد.
rkey : کد منحصر بفرد تولید شده برای شناسایی کاربر میباشد. در صورتیکه فیلد error در خروجی مقدار true را داشته باشد، rkey برای فرد تولید میشود، در غیر اینصورت مقدار null خواهد داشت.
url : این فیلد در صورتی مقدار خواهد داشت که در ورودی فیلد referer مقداردهی شده باشد، در غیر اینصورت خالی خواهد بود. در صورتیکه بخواهیم کاربر بعد از این مرحله به صفحه ای منتقل شود که قبل از آن در آنجا قرار داشته است، باید نام صفحه را در ورودی دستور با نام referer ارسال کرده و در خروجی از آن استفاده کنیم (برابر با مقدار referer در ورودی خواهد بود).
4-2- ثبت رمز عبور جدید
Rkey تولید شده در دستور درخواست تغییر رمز عبور را، باید از طریق ایمیل برای کاربر ارسال نمود (که یکی از روش های آن ارسال ایمیل با استفاده از دستورات بیسیس کور میباشد). با کلیک بر روی لینک تغییر رمز عبور موجود در ایمیل، این rkey به صفحه ای از سایت ارسال شده و کاربر با ثبت رمز جدید و با استفاده از دستور زیر میتواند رمز عبور جدید را برای خود تعریف نماید.
خروجی:
خروجی یک رکورد شامل فیلدهای زیر میباشد :
error : در صورتیکه عملیات تغییر رمز عبور با موفقیت انجام گیرد، مقدار این فیلد true خواهد بود، در غیر اینصورت متن خطای مربوطه نمایش داده خواهد شد.
rkey : کد منحصر بفرد تولید شده برای شناسایی کاربر میباشد. در صورتیکه فیلدerror در خروجی مقدار true را داشته باشد، rkey فرد نمایش داده میشود، در غیر اینصورت مقدار null خواهد داشت.
url : این فیلد در صورتی مقدار خواهد داشت که در ورودی فیلد referer مقداردهی شده باشد، در غیر اینصورت خالی خواهد بود. در صورتیکه بخواهیم کاربر بعد از این مرحله به صفحه ای منتقل شود که قبل از آن در آنجا قرار داشته است، باید نام صفحه را در ورودی دستور با نام referer ارسال کرده و در خروجی از آن استفاده کنیم (برابر با مقدار referer در ورودی خواهد بود).
5- خروج
برای خروج از وضعیت لاگین ، میتوان از دستور زیر استفاده نمود.
خروجی:
خروجی یک فیلد بصورت زیر میباشد :
error : در صورتیکه عملیات خروج با موفقیت انجام گیرد، پیغام موفقیت، و در غیر اینصورت متن خطای مربوطه نمایش داده خواهد شد.
