dolibarr 18.0.6
oauth.php
Go to the documentation of this file.
1<?php
2/* Copyright (C) 2015-2018 Frederic France <frederic.france@netlogic.fr>
3 * Copyright (C) 2016 Raphaƫl Doursenaud <rdoursenaud@gpcsolutions.fr>
4 * Copyright (C) 2022 Laurent Destailleur <eldy@users.sourceforge.net>
5 *
6 * This program is free software; you can redistribute it and/or modify
7 * it under the terms of the GNU General Public License as published by
8 * the Free Software Foundation; either version 3 of the License, or
9 * (at your option) any later version.
10 *
11 * This program is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 * GNU General Public License for more details.
15 *
16 * You should have received a copy of the GNU General Public License
17 * along with this program. If not, see <https://www.gnu.org/licenses/>.
18 */
19
27// Load Dolibarr environment
28require '../main.inc.php';
29require_once DOL_DOCUMENT_ROOT.'/core/lib/admin.lib.php';
30require_once DOL_DOCUMENT_ROOT.'/core/lib/oauth.lib.php';
31
32// $supportedoauth2array is defined into oauth.lib.php
33
34// Define $urlwithroot
35$urlwithouturlroot = preg_replace('/'.preg_quote(DOL_URL_ROOT, '/').'$/i', '', trim($dolibarr_main_url_root));
36$urlwithroot = $urlwithouturlroot.DOL_URL_ROOT; // This is to use external domain name found into config file
37//$urlwithroot=DOL_MAIN_URL_ROOT; // This is to use same domain name than current
38
39// Load translation files required by the page
40$langs->loadLangs(array('admin', 'oauth', 'modulebuilder'));
41
42// Security check
43if (!$user->admin) {
45}
46
47$action = GETPOST('action', 'aZ09');
48$provider = GETPOST('provider', 'aZ09');
49$label = GETPOST('label', 'aZ09');
50
51$servicetoeditname = GETPOST('servicetoeditname', 'aZ09');
52
53$error = 0;
54
55
56/*
57 * Actions
58 */
59
60if ($action == 'add') { // $provider is OAUTH_XXX
61 if ($provider && $provider != '-1') {
62 $constname = strtoupper($provider).($label ? '-'.$label : '').'_ID';
63
64 if (getDolGlobalString($constname)) {
65 setEventMessages($langs->trans("AOAuthEntryForThisProviderAndLabelAlreadyHasAKey"), null, 'errors');
66 $error++;
67 } else {
68 dolibarr_set_const($db, $constname, $langs->trans('ToComplete'), 'chaine', 0, '', $conf->entity);
69 setEventMessages($langs->trans("OAuthProviderAdded"), null);
70 }
71 }
72}
73if ($action == 'update') {
74 foreach ($conf->global as $key => $val) {
75 if (!empty($val) && preg_match('/^OAUTH_.+_ID$/', $key)) {
76 $constvalue = str_replace('_ID', '', $key);
77 $newconstvalue = $constvalue;
78 if (GETPOSTISSET($constvalue.'_NAME')) {
79 $newconstvalue = preg_replace('/-.*$/', '', $constvalue).'-'.GETPOST($constvalue.'_NAME');
80 }
81
82 if (GETPOSTISSET($constvalue.'_ID')) {
83 if (!dolibarr_set_const($db, $newconstvalue.'_ID', GETPOST($constvalue.'_ID'), 'chaine', 0, '', $conf->entity)) {
84 $error++;
85 }
86 }
87 // If we reset this provider, we also remove the secret
88 if (GETPOSTISSET($constvalue.'_SECRET')) {
89 if (!dolibarr_set_const($db, $newconstvalue.'_SECRET', GETPOST($constvalue.'_ID') ? GETPOST($constvalue.'_SECRET') : '', 'chaine', 0, '', $conf->entity)) {
90 $error++;
91 }
92 }
93 if (GETPOSTISSET($constvalue.'_URLAUTHORIZE')) {
94 if (!dolibarr_set_const($db, $newconstvalue.'_URLAUTHORIZE', GETPOST($constvalue.'_URLAUTHORIZE'), 'chaine', 0, '', $conf->entity)) {
95 $error++;
96 }
97 }
98 if (GETPOSTISSET($constvalue.'_TENANT')) {
99 if (!dolibarr_set_const($db, $constvalue.'_TENANT', GETPOST($constvalue.'_TENANT'), 'chaine', 0, '', $conf->entity)) {
100 $error++;
101 }
102 }
103 if (GETPOSTISSET($constvalue.'_SCOPE')) {
104 if (is_array(GETPOST($constvalue.'_SCOPE'))) {
105 $scopestring = implode(',', GETPOST($constvalue.'_SCOPE'));
106 } else {
107 $scopestring = GETPOST($constvalue.'_SCOPE');
108 }
109 if (!dolibarr_set_const($db, $newconstvalue.'_SCOPE', $scopestring, 'chaine', 0, '', $conf->entity)) {
110 $error++;
111 }
112 } elseif ($newconstvalue !== $constvalue) {
113 if (!dolibarr_set_const($db, $newconstvalue.'_SCOPE', '', 'chaine', 0, '', $conf->entity)) {
114 $error++;
115 }
116 }
117
118 // If name changed, we have to delete old const and proceed few other changes
119 if ($constvalue !== $newconstvalue) {
120 dolibarr_del_const($db, $constvalue.'_ID', $conf->entity);
121 dolibarr_del_const($db, $constvalue.'_SECRET', $conf->entity);
122 dolibarr_del_const($db, $constvalue.'_URLAUTHORIZE', $conf->entity);
123 dolibarr_del_const($db, $constvalue.'_SCOPE', $conf->entity);
124
125 // Update name of token
126 $oldname = preg_replace('/^OAUTH_/', '', $constvalue);
127 $oldprovider = ucfirst(strtolower(preg_replace('/-.*$/', '', $oldname)));
128 $oldlabel = preg_replace('/^.*-/', '', $oldname);
129 $newlabel = preg_replace('/^.*-/', '', $newconstvalue);
130
131
132 $sql = "UPDATE ".MAIN_DB_PREFIX."oauth_token";
133 $sql.= " SET service = '".$db->escape($oldprovider."-".$newlabel)."'";
134 $sql.= " WHERE service = '".$db->escape($oldprovider."-".$oldlabel)."'";
135
136
137 $resql = $db->query($sql);
138 if (!$resql) {
139 $error++;
140 }
141
142 // Update const where the token was used, might not be exhaustive
143 if (getDolGlobalString('MAIN_MAIL_SMTPS_OAUTH_SERVICE') == $oldname) {
144 if (!dolibarr_set_const($db, 'MAIN_MAIL_SMTPS_OAUTH_SERVICE', strtoupper($oldprovider).'-'.$newlabel, 'chaine', 0, '', $conf->entity)) {
145 $error++;
146 }
147 }
148 }
149 }
150 }
151
152
153 if (!$error) {
154 setEventMessages($langs->trans("SetupSaved"), null);
155 } else {
156 setEventMessages($langs->trans("Error"), null, 'errors');
157 }
158}
159
160if ($action == 'confirm_delete') {
161 $provider = GETPOST('provider', 'aZ09');
162 $label = GETPOST('label');
163
164 $globalkey = empty($provider) ? $label : $label.'-'.$provider;
165
166 if (getDolGlobalString($globalkey.'_ID') && getDolGlobalString($globalkey.'_SECRET')) { // If ID and secret exist, we delete first the token
167 $backtourl = DOL_URL_ROOT.'/admin/oauth.php?action=delete_entry&provider='.$provider.'&label='.$label.'&token='.newToken();
168 $urlwithouturlroot = preg_replace('/'.preg_quote(DOL_URL_ROOT, '/').'$/i', '', trim($dolibarr_main_url_root));
169 $urlwithroot = $urlwithouturlroot.DOL_URL_ROOT;
170 $callbacktodel = $urlwithroot;
171 if ($label == 'OAUTH_GOOGLE') {
172 $callbacktodel .= '/core/modules/oauth/google_oauthcallback.php?action=delete&keyforprovider='.$provider.'&token='.newToken().'&backtourl='.urlencode($backtourl);
173 } elseif ($label == 'OAUTH_GITHUB') {
174 $callbacktodel .= '/core/modules/oauth/github_oauthcallback.php?action=delete&keyforprovider='.$provider.'&token='.newToken().'&backtourl='.urlencode($backtourl);
175 } elseif ($label == 'OAUTH_STRIPE_LIVE') {
176 $callbacktodel .= '/core/modules/oauth/stripelive_oauthcallback.php?action=delete&keyforprovider='.$provider.'&token='.newToken().'&backtourl='.urlencode($backtourl);
177 } elseif ($label == 'OAUTH_STRIPE_TEST') {
178 $callbacktodel .= '/core/modules/oauth/stripetest_oauthcallback.php?action=delete&keyforprovider='.$provider.'&token='.newToken().'&backtourl='.urlencode($backtourl);
179 } elseif ($label == 'OAUTH_MICROSOFT') {
180 $callbacktodel .= '/core/modules/oauth/microsoft_oauthcallback.php?action=delete&keyforprovider='.$provider.'&token='.newToken().'&backtourl='.urlencode($backtourl);
181 } elseif ($label == 'OAUTH_OTHER') {
182 $callbacktodel .= '/core/modules/oauth/generic_oauthcallback.php?action=delete&keyforprovider='.$provider.'&token='.newToken().'&backtourl='.urlencode($backtourl);
183 }
184 header("Location: ".$callbacktodel);
185 exit;
186 } else {
187 $action = 'delete_entry';
188 }
189}
190
191if ($action == 'delete_entry') {
192 $provider = GETPOST('provider', 'aZ09');
193 $label = GETPOST('label');
194
195 $globalkey = empty($provider) ? $label : $label.'-'.$provider;
196
197 if (!dolibarr_del_const($db, $globalkey.'_NAME', $conf->entity) || !dolibarr_del_const($db, $globalkey.'_ID', $conf->entity) || !dolibarr_del_const($db, $globalkey.'_SECRET', $conf->entity) || !dolibarr_del_const($db, $globalkey.'_URLAUTHORIZE', $conf->entity) || !dolibarr_del_const($db, $globalkey.'_SCOPE', $conf->entity)) {
198 setEventMessages($langs->trans("ErrorInEntryDeletion"), null, 'errors');
199 $error++;
200 } else {
201 setEventMessages($langs->trans("EntryDeleted"), null);
202 }
203}
204
205/*
206 * View
207 */
208
209llxHeader();
210
211$form = new Form($db);
212// Confirmation of action process
213if ($action == 'delete') {
214 $formquestion = array();
215 $formconfirm = $form->formconfirm($_SERVER["PHP_SELF"].'?provider='.GETPOST('provider').'&label='.GETPOST('label'), $langs->trans('OAuthServiceConfirmDeleteTitle'), $langs->trans('OAuthServiceConfirmDeleteMessage'), 'confirm_delete', $formquestion, 0, 1, 220);
216 print $formconfirm;
217}
218
219
220$linkback = '<a href="'.DOL_URL_ROOT.'/admin/modules.php?restore_lastsearch_values=1">'.$langs->trans("BackToModuleList").'</a>';
221print load_fiche_titre($langs->trans('ConfigOAuth'), $linkback, 'title_setup');
222
223print '<form action="'.$_SERVER["PHP_SELF"].'" method="POST">';
224print '<input type="hidden" name="token" value="'.newToken().'">';
225print '<input type="hidden" name="action" value="add">';
226
228
229print dol_get_fiche_head($head, 'services', '', -1, '');
230
231
232print '<span class="opacitymedium">'.$langs->trans("ListOfSupportedOauthProviders").'</span><br><br>';
233
234
235print '<select name="provider" id="provider" class="minwidth150">';
236print '<option name="-1" value="-1">'.$langs->trans("OAuthProvider").'</option>';
237foreach ($list as $key) {
238 $supported = 0;
239 $keyforsupportedoauth2array = $key[0];
240
241 if (in_array($keyforsupportedoauth2array, array_keys($supportedoauth2array))) {
242 $supported = 1;
243 }
244 if (!$supported) {
245 continue; // show only supported
246 }
247
248 $i++;
249 print '<option name="'.$keyforsupportedoauth2array.'" value="'.str_replace('_NAME', '', $keyforsupportedoauth2array).'">'.$supportedoauth2array[$keyforsupportedoauth2array]['name'].'</option>'."\n";
250}
251print '</select>';
252print ajax_combobox('provider');
253print ' <input type="text" name="label" value="" placeholder="'.$langs->trans("Label").'" pattern="^\S+$" title="'.$langs->trans("SpaceOrSpecialCharAreNotAllowed").'">';
254print ' <input type="submit" class="button small" name="add" value="'.$langs->trans("Add").'">';
255
256print '<br>';
257print '<br>';
258
259print dol_get_fiche_end();
260
261print '</form>';
262
263$listinsetup = [];
264// Define $listinsetup
265foreach ($conf->global as $key => $val) {
266 if (!empty($val) && preg_match('/^OAUTH_.*_ID$/', $key)) {
267 $provider = preg_replace('/_ID$/', '', $key);
268 $listinsetup[] = array(
269 $provider.'_NAME',
270 $provider.'_ID',
271 $provider.'_SECRET',
272 $provider.'_URLAUTHORIZE', // For custom oauth links
273 $provider.'_SCOPE' // For custom oauth links
274 );
275 }
276}
277
278
279if (count($listinsetup) > 0) {
280 print '<form action="'.$_SERVER["PHP_SELF"].'" method="POST">';
281 print '<input type="hidden" name="token" value="'.newToken().'">';
282 print '<input type="hidden" name="action" value="update">';
283
284 print '<div class="div-table-responsive-no-min">';
285
286 $i = 0;
287
288 // $list is defined into oauth.lib.php to the list of supporter OAuth providers.
289 foreach ($listinsetup as $key) {
290 $supported = 0;
291 $keyforsupportedoauth2array = $key[0]; // May be OAUTH_GOOGLE_NAME or OAUTH_GOOGLE_xxx_NAME
292 $keyforsupportedoauth2array = preg_replace('/^OAUTH_/', '', $keyforsupportedoauth2array);
293 $keyforsupportedoauth2array = preg_replace('/_NAME$/', '', $keyforsupportedoauth2array);
294 if (preg_match('/^.*-/', $keyforsupportedoauth2array)) {
295 $keybeforeprovider = preg_replace('/-.*$/', '', $keyforsupportedoauth2array);
296 $keyforprovider = preg_replace('/^.*-/', '', $keyforsupportedoauth2array);
297 } else {
298 $keybeforeprovider = $keyforsupportedoauth2array;
299 $keyforprovider = '';
300 }
301 $keyforsupportedoauth2array = preg_replace('/-.*$/', '', $keyforsupportedoauth2array);
302 $keyforsupportedoauth2array = 'OAUTH_'.$keyforsupportedoauth2array.'_NAME';
303
304 if (in_array($keyforsupportedoauth2array, array_keys($supportedoauth2array))) {
305 $supported = 1;
306 }
307 if (!$supported) {
308 continue; // show only supported
309 }
310
311 $i++;
312
313 print '<table class="noborder centpercent">';
314
315 // OAUTH service name
316 $label = $langs->trans($keyforsupportedoauth2array);
317 print '<tr class="liste_titre'.($i > 1 ? ' liste_titre_add' : '').'">';
318 print '<td class="titlefieldcreate">';
319 print img_picto('', $supportedoauth2array[$keyforsupportedoauth2array]['picto'], 'class="pictofixedwidth"');
320 if ($label == $keyforsupportedoauth2array) {
321 print $supportedoauth2array[$keyforsupportedoauth2array]['name'];
322 } else {
323 print $label;
324 }
325 if ($servicetoeditname == $key[0]) {
326 print ' (<input style="width: 20%" type="text" name="'.$key[0].'" value="'.$keyforprovider.'" >)';
327 } elseif ($keyforprovider) {
328 print ' (<b>'.$keyforprovider.'</b>)';
329 } else {
330 print ' (<b>'.$langs->trans("NoName").'</b>)';
331 }
332 if (!($servicetoeditname == $key[0])) {
333 print '<a class="editfielda reposition" href="'.$_SERVER["PHP_SELF"].'?token='.newToken().'&servicetoeditname='.urlencode($key[0]).'">'.img_edit($langs->transnoentitiesnoconv('Edit'), 1).'</a>';
334 }
335 print '</td>';
336 print '<td>';
337 if (!empty($supportedoauth2array[$keyforsupportedoauth2array]['urlforcredentials'])) {
338 print $langs->trans("OAUTH_URL_FOR_CREDENTIAL", $supportedoauth2array[$keyforsupportedoauth2array]['urlforcredentials']);
339 }
340 print '</td>';
341
342 // Delete
343 print '<td>';
344 $label = preg_replace('/_NAME$/', '', $keyforsupportedoauth2array);
345 print '<a href="'.$_SERVER["PHP_SELF"].'?action=delete&token='.newToken().'&provider='.urlencode($keyforprovider).'&label='.urlencode($label).'">';
346 print img_picto('', 'delete');
347 print '</a>';
348
349 print '</form>';
350 print '</td>';
351
352 print '</tr>';
353
354 if ($supported) {
355 $redirect_uri = $urlwithroot.'/core/modules/oauth/'.$supportedoauth2array[$keyforsupportedoauth2array]['callbackfile'].'_oauthcallback.php';
356 print '<tr class="oddeven value">';
357 print '<td>'.$langs->trans("UseTheFollowingUrlAsRedirectURI").'</td>';
358 print '<td><input style="width: 80%" type="text" name="uri'.$keyforsupportedoauth2array.'" id="uri'.$keyforsupportedoauth2array.$keyforprovider.'" value="'.$redirect_uri.'" disabled>';
359 print ajax_autoselect('uri'.$keyforsupportedoauth2array.$keyforprovider);
360 print '</td>';
361 print '<td></td>';
362 print '</tr>';
363
364 if ($keyforsupportedoauth2array == 'OAUTH_OTHER_NAME') {
365 print '<tr class="oddeven value">';
366 print '<td>'.$langs->trans("URLOfServiceForAuthorization").'</td>';
367 print '<td><input style="width: 80%" type="text" name="'.$key[3].'" value="'.getDolGlobalString($key[3]).'" >';
368 print '</td>';
369 print '<td></td>';
370 print '</tr>';
371 }
372 } else {
373 print '<tr class="oddeven value">';
374 print '<td>'.$langs->trans("UseTheFollowingUrlAsRedirectURI").'</td>';
375 print '<td>'.$langs->trans("FeatureNotYetSupported").'</td>';
376 print '</td>';
377 print '<td></td>';
378 print '</tr>';
379 }
380
381 // Api Id
382 print '<tr class="oddeven value">';
383 print '<td><label for="'.$key[1].'">'.$langs->trans("OAUTH_ID").'</label></td>';
384 print '<td><input type="text" size="100" id="'.$key[1].'" name="'.$key[1].'" value="'.getDolGlobalString($key[1]).'">';
385 print '</td>';
386 print '<td></td>';
387 print '</tr>';
388
389 // Api Secret
390 print '<tr class="oddeven value">';
391 print '<td><label for="'.$key[2].'">'.$langs->trans("OAUTH_SECRET").'</label></td>';
392 print '<td><input type="password" size="100" id="'.$key[2].'" name="'.$key[2].'" value="'.getDolGlobalString($key[2]).'">';
393 print '</td>';
394 print '<td></td>';
395 print '</tr>';
396
397 // Tenant
398 if ($keybeforeprovider == 'MICROSOFT') {
399 print '<tr class="oddeven value">';
400 print '<td><label for="'.$key[2].'">'.$langs->trans("OAUTH_TENANT").'</label></td>';
401 print '<td><input type="text" size="100" id="OAUTH_'.$keybeforeprovider.($keyforprovider ? '-'.$keyforprovider : '').'_TENANT" name="OAUTH_'.$keybeforeprovider.($keyforprovider ? '-'.$keyforprovider : '').'_TENANT" value="'.getDolGlobalString('OAUTH_'.$keybeforeprovider.($keyforprovider ? '-'.$keyforprovider : '').'_TENANT').'">';
402 print '</td>';
403 print '<td></td>';
404 print '</tr>';
405 }
406
407 // TODO Move this into token generation ?
408 if ($supported) {
409 if ($keyforsupportedoauth2array == 'OAUTH_OTHER_NAME') {
410 print '<tr class="oddeven value">';
411 print '<td>'.$langs->trans("Scopes").'</td>';
412 print '<td>';
413 print '<input style="width: 80%" type"text" name="'.$key[4].'" value="'.getDolGlobalString($key[4]).'" >';
414 print '</td>';
415 print '<td></td>';
416 print '</tr>';
417 } else {
418 $availablescopes = array_flip(explode(',', $supportedoauth2array[$keyforsupportedoauth2array]['availablescopes']));
419 $currentscopes = explode(',', getDolGlobalString($key[4]));
420 $scopestodispay = array();
421 foreach ($availablescopes as $keyscope => $valscope) {
422 if (in_array($keyscope, $currentscopes)) {
423 $scopestodispay[$keyscope] = 1;
424 } else {
425 $scopestodispay[$keyscope] = 0;
426 }
427 }
428 // Api Scope
429 print '<tr class="oddeven value">';
430 print '<td>'.$langs->trans("Scopes").'</td>';
431 print '<td>';
432 foreach ($scopestodispay as $scope => $val) {
433 print '<input type="checkbox" id="'.$keyforprovider.$scope.'" name="'.$key[4].'[]" value="'.$scope.'"'.($val ? ' checked' : '').'>';
434 print '<label style="margin-right: 10px" for="'.$keyforprovider.$scope.'">'.$scope.'</label>';
435 }
436 print '</td>';
437 print '<td></td>';
438 print '</tr>';
439 }
440 } else {
441 print '<tr class="oddeven value">';
442 print '<td>'.$langs->trans("UseTheFollowingUrlAsRedirectURI").'</td>';
443 print '<td>'.$langs->trans("FeatureNotYetSupported").'</td>';
444 print '</td>';
445 print '<td></td>';
446 print '</tr>';
447 }
448
449 print '</table>'."\n";
450
451 print '<br>';
452 }
453
454 print '</div>';
455
456 print $form->buttonsSaveCancel("Save", '');
457
458 print '</form>';
459}
460
461// End of page
462llxFooter();
463$db->close();
dolibarr_set_const($db, $name, $value, $type='chaine', $visible=0, $note='', $entity=1)
Insert a parameter (key,value) into database (delete old key then insert it again).
dolibarr_del_const($db, $name, $entity=1)
Delete a constant.
ajax_combobox($htmlname, $events=array(), $minLengthToAutocomplete=0, $forcefocus=0, $widthTypeOfAutocomplete='resolve', $idforemptyvalue='-1', $morecss='')
Convert a html select field into an ajax combobox.
Definition ajax.lib.php:464
if(!defined('NOREQUIRESOC')) if(!defined( 'NOREQUIRETRAN')) if(!defined('NOTOKENRENEWAL')) if(!defined( 'NOREQUIREMENU')) if(!defined('NOREQUIREHTML')) if(!defined( 'NOREQUIREAJAX')) llxHeader()
Empty header.
Definition wrapper.php:56
llxFooter()
Empty footer.
Definition wrapper.php:70
Class to manage generation of HTML components Only common components must be here.
load_fiche_titre($titre, $morehtmlright='', $picto='generic', $pictoisfullpath=0, $id='', $morecssontable='', $morehtmlcenter='')
Load a title with picto.
dol_get_fiche_head($links=array(), $active='', $title='', $notab=0, $picto='', $pictoisfullpath=0, $morehtmlright='', $morecss='', $limittoshow=0, $moretabssuffix='', $dragdropfile=0)
Show tabs of a record.
dol_get_fiche_end($notab=0)
Return tab footer of a card.
img_picto($titlealt, $picto, $moreatt='', $pictoisfullpath=false, $srconly=0, $notitle=0, $alt='', $morecss='', $marginleftonlyshort=2)
Show picto whatever it's its name (generic function)
ajax_autoselect($htmlname, $addlink='', $textonlink='Link')
Make content of an input box selected when we click into input field.
GETPOST($paramname, $check='alphanohtml', $method=0, $filter=null, $options=null, $noreplace=0)
Return value of a param into GET or POST supervariable.
setEventMessages($mesg, $mesgs, $style='mesgs', $messagekey='', $noduplicate=0)
Set event messages in dol_events session object.
getDolGlobalString($key, $default='')
Return dolibarr global constant string value.
img_edit($titlealt='default', $float=0, $other='')
Show logo editer/modifier fiche.
oauthadmin_prepare_head()
Return array of tabs to used on pages to setup cron module.
accessforbidden($message='', $printheader=1, $printfooter=1, $showonlymessage=0, $params=null)
Show a message to say access is forbidden and stop program.