🥇 SAP GUI käivitamine brauserist

Selle artikli kirjutasin alguses oma blogi, et hiljem ei peaks uuesti otsima ja meenutama, aga kuna keegi ei loe blogi, siis tahtsin seda teavet kõigiga jagada, äkki kellelegi tuleb see kasuks.

Töötades SAP R/3 parooli lähtestamise teenuse idee kallal, tekkis küsimus — kuidas käivitada SAP GUI vajalike parameetritega brauserist? Kuna see idee hõlmas veebiteenuse kasutamist, mis töötas kõigepealt SOAP-päringu kaudu SAP GUI-st ja saatis seejärel e-kirja lingiga veebilehte, kus oli parooli lähtestamise skript, ja pärast seda kuvati kasutajale sõnum edukast parooli lähtestamisest ja see algne parool, siis tahtsin, et sellel lehel oleks ka link SAP GUI avamiseks. Samuti, et see link avaks vajaliku süsteemi ja soovitavalt kohe täidetud sisselogimise ja parooli väljad: kasutajal jääb ainult täita tootmisparool kaks korda.

SAP Logoni käivitamine ei olnud meie eesmärgil huvitav, aga sapgui.exe käivitamisel ei saanud määrata mandanti ja kasutajanime, kuid süsteemi sai siiski käivitada, mis ei olnud SAP Logonis määratletud. Teisest küljest, SAP GUI käivitamine suvaliste serveri parameetritega ei olnud eriti aktuaalne: kui lahendame kasutaja parooli lähtestamise probleemi, siis tõenäoliselt on tal juba SAP Logonis vajalik rida vajalike seadistustega ja ei ole vaja oma seadistusi lisada. Siiski vastas nõuetele tehnoloogia SAP GUI Shortcut ja programm sapshcut.exe, mis võimaldas käivitada SAP GUI teatud

Lahendus otse: sapshcut.exe käitamine brauserist ActiveX objekti abil:

function openSAPGui(sid, client, user, password) {
var shell = new ActiveXObject("WScript.Shell");
shell.run('sapshcut.exe -system="'+sid+'" -client='+client+' -user="'+user+'" -pw="'+password+'" -language=RU');
}

Lahendus on halb: esiteks töötab see ainult Internet Exploreris, teiseks nõuab see vastavaid turvaseadeid brauseris, mis võivad organisatsioonis olla domeenil põhinevalt keelatud, ja isegi kui need on lubatud, siis näitab brauser kasutajale hirmutavat hoiatusteadet:

Lahendus №2 leidsin internetist: enda veebiprotokolli loomine. See võimalik käivitada vajalik rakendus lingi kaudu, määrates protokolli, mille registreerime Windowsis registris HKEY_CLASSES_ROOT jaotises. Kuna SAP GUI Shortcutil on selles jaotises oma ala, saame sinna lisada stringiparameetri URL Protocol tühja väärtusega:

See protokoll käivitab sapgui.exe parameetriga /SHORTCUT, mis meie jaoks vajalik on:

Või kui soovime teha suvalise protokolli (näiteks, sapshcut), siis saame selle registreerida järgmise reg-failiga:

Windowsi registri redaktor versioon 5.00 [HKEY_CLASSES_ROOTsapshcut] @="sapshcut Handler" "URL Protokoll"="" [HKEY_CLASSES_ROOTsapshcutDefaultIcon] @="sapshcut.exe" [HKEY_CLASSES_ROOTsapshcutshell] [HKEY_CLASSES_ROOTsapshcutshellopen] [HKEY_CLASSES_ROOTsapshcutshellopencommand] @="sapshcut.exe "%1""
Nüüd, kui me veebilehel loome lingi protokolli määramisega Sapgui.Shortcut.File niimoodi:

<a href='Sapgui.Shortcut.File: -system=SID -client=200'>SID200</a>

meil peaks avanema järgmine aken:

Ja tundub, et kõik on hästi, aga kui vajutame ‘Luba’ nuppu, näeme:

Oi, brauser muundas tühiku -ks. Samuti kodeeritakse teised sümbolid nende numbrikoodideks protsendi sümboliga. Ja kõige ebameeldivam on see, et brauseri tasemel ei saa midagi teha (see on kõik standardite kohaselt tehtud) — brauser ei talu selliseid sümboleid, ja Windowsi käsurea tõlgendaja ei tööta selliste kodeeritud väärtustega. Ja veel üks miinus — parameetrina edastatakse kogu string, sealhulgas protokolli nimi ja isegi koolon:sapgui.shortcut.file:). Kuigi sama sapshcut.exe oskab kõrvaldada kõik, mis ei ole tema jaoks parameeter (alustades sümbolist ‘-‘, siis nimi, ‘=’ ja väärtus), st rida nagu ‘sapgui.shortcut.file: -system=SID’ töötab, aga ilma tühikuta ‘sapgui.shortcut.file:-system=SID’ ei tööta enam.

Kokkuvõttes on olemas kaks varianti URI-protokolli kasutamiseks:

Kasutamine ilma parameetrita: Loome hulga protokolle meie süsteemide jaoks nagu SIDMANDT, näiteks AAA200, BBB200 jne. Kui on vaja lihtsalt vajalik süsteem käivitada, siis see variant on täiesti toimiv, aga meie puhul ei sobi, kuna tahaksime ka kasutajanime edastada, mida niimoodi teha ei saa.
Kasutame wrapper-programmi kutsumiseks sapshcut.exe või sapgui.exeAntud programmi olemus on lihtne — see peab võtma selle rea, mille brauser edastab veebiprotokolli kaudu, ja muutma selle esituseks, mida Windows vastu võtab, st muudab kõik sümbolite koodid tagasi sümboliteks (võib-olla isegi analüüsib rea parameetreid) ning kutsub välja SAP GUI garanteeritult õige käsuga. Meie jaoks ei sobi see ka päris hästi (seetõttu ei hakanud ma seda kirjutama), sest meil on juba vähe, et lisada protokoll kõikidele kasutajakontodele (domeenis on see veel mõeldav, ehkki tasub vältida sellist praktikat), kuid siin on veel vaja programm paigaldada arvutisse ja pidevalt jälgida, et see ei kaoks tarkvara uuendamise käigus.

Seega viskame ka selle variandi kõrvale, kuna see ei sobi meile.

Siin hakkasin juba mõtlema, et tuleb loobuda ideest käivitada SAP GUI vajalike parameetritega brauserist, kuid mõte tuli, et SAP Logonis saab luua otsetee ja selle saab kopeerida töölauale. Olen kunagi sellist viisi kasutanud, kuid enne ei olnud ma otsetee faili spetsiaalselt vaadanud. Selgus, et see otsetee on tavaline tekstifail laiendiga .sap. Ja kui seda Windowsis avada — käivitub SAP GUI parameetritega, mis on selles failis märgitud. "Bingo!"

Selle faili formaat on umbes järgmine (seal võib olla ka käivitatav tehing alguses, kuid ma jätsin selle välja):

[System] Nimi=SID Kliendi=200 [User] Nimi= Keel=RU Parool= [Function] Pealkiri= [Configuration] GuiSuurus=Maximeeritud [Options] Taaskasuta=0
Tundub, et kõik vajalik on olemas: ning süsteemi identifikaator, mandant, kasutajanimi ja isegi parool. Ja isegi lisaparameetrid: Title — akna pealkiri, GuiSize — akna suurus (kas täisekraan või mitte) ja Reuse — kas avada kindlasti uus aken või kasutada juba avatud sama süsteemiga. Kuid kohe tuli probleem — SAP Logonis ei saanud parooli seada, väli oli lukustatud. Selgus, et see on tehtud turvakaalutlustel: kõik SAP Logonis loodud otseteed salvestatakse failis sapshortcut.ini (Windowsi kasutajaprofiili kõrval asuv saplogon.ini fail) ja seal on need, kuigi salastatud, mitte liiga tugevalt ning suure sooviga on need võimalik dekrüpteerida. Kuid seda on võimalik lubada, muutes ühe parameetri väärtust registris (vaikimisi väärtus 0):

Windowsi registri redaktor versioon 5.00 [HKEY_CURRENT_USERSoftwareSAPSAPShortcutSecurity] "EnablePassword"="1"
See vabastab parooli sisestamiseks välja SAP Logoni otsetee loomise vormis:

Ja kui sisestate selle välja parooli, siis see kuvatakse vastavas reas.
sapshortcut.ini, aga kui lohistada otsetee töölaud, siis see ei ilmu sinna – aga saate selle sinna käsitsi lisada. Parool on krüptitud, 111111 puhul on selle vorm järgmine: PW_49B02219D1F6, 222222 puhul – PW_4AB3211AD2F5. Kuid meid huvitab rohkem see, et see parool krüptitakse ühtemoodi, mis ei sõltu konkreetsest arvutist ja kui me taastame parooli algseisusse, siis saame selles välja kasutada ühte eelnevalt teadaolevat väärtust. Kui aga tahame kasutada vabalt loodud parooli, peame mõistma selle krüptimisalgoritmi. Aga antud näidete järgi ei tohiks seda keeruline olla. Muide, SAP GUI 7.40-s on see väli üldse vormist kadunud, aga fail, millel on täidetud parool, tunnustatakse korrektselt.

See tähendab, et brauseris piisab failile, millel on laiend .sap ja õige formaadiga klõpsamisest – ja see pakub välja avada selle SAP GUI otsetee failina (loomulikult arvutis, kus on paigaldatud SAP GUI) ja avab meile SAP GUI akna näidatud parameetritega (kui SID ja mandaant on sellel arvutil SAP Logoni nimekirjas).

Aga muidugi ei hakka keegi lihtsalt faile eelnevalt looma ja veebilehele ladustama – need tuleb genereerida lähtudes vajalikest parameetritest. Näiteks võib luua PHP skripti otseteede genereerimiseks (sapshcut.php):

<?php
$queries = array();
parse_str($_SERVER['QUERY_STRING'], $queries);
$Title = $queries['Title'];
$Size = $queries['Size'];
$SID = $queries['SID'];
$Client = $queries['Client'];
if($Client == '') { $Client=200; };
$Lang = $queries['Language'];
if($Lang=='') { $Lang = 'RU'; };
$User = $queries['Username'];
if($User'') { $Password = $queries['Password']; };
$filename = $SID.$Client.'.sap';
header('Content-disposition: attachment; filename='.$filename);
header('Content-type: application/sap');
echo "[System]rn";
echo "Name=".$SID."rn";
echo "Client=".$Client."rn";
echo "[User]rn";
echo "Name=".$Username."rn";
echo "Language=".$Lang."rn";
if($Password'') echo "Password=".$Password."rn";
echo "[Function]rn";
if($Title'') {echo "Title=".$Title."rn";} else {echo "Title=Süsteemi siseneminern";};
echo "[Configuration]rn";
if($Size=='max') { echo "GuiSize=Maximizedrn"; };
echo "[Options]rn";
echo "Reuse=0rn";
?>

Kui kasutajanime ja parooli ei sisestata, siis saame järgmise akna logi ja parooli küsimisega:

Kui edastada ainult kasutajanimi, siis kasutajanime väljad on täidetud, kuid parooli väli jääb tühjaks. Kui me edastame nii kasutajanime kui parooli, kuid kasutaja registris on võtme EnablePassword väärtus [HKEY_CURRENT_USERSoftwareSAPSAPShortcutSecurity] seatud 0-le, siis saame sama tulemuse. Ainult juhul, kui see võti on seatud 1-le ja me edastame nii nime kui algse parooli, palub süsteem kohe kahel korral sisestada uus alaline parool. Just seda soovisime saavutada.

Kokkuvõttes saame järgmise kaalutud võimaluste kogumi, et illustreerida eelöeldut:

<html>
<head>
<script>
function openSAPGui(sid, client, user, password) {
var shell = new ActiveXObject("WScript.Shell");
shell.run('sapshcut.exe -system="'+sid+'" -client='+client+' -user="'+user+'" -pw="'+password+'" -language=RU');
}
</script>
</head>
<body>
<a href='' onclick="javascript:openSAPGui('SID', '200', 'test', '');"/>Näide 1: Käivita sapshcut.exe (ActiveX)<br>
<a href='Sapgui.Shortcut.File: -system=SID -client=200'>Näide 2: Avage sapshcut.exe (URI)</a><br>
<a href='/et/sapshcut.php/?SID=SID&Client=200&User=test'>Näide 3: Avage fail .sap (SAP GUI otsetee)</a><br>
</body>
</html>

Viimane variant sobis mulle. Samuti on võimalik SAP-i otseteed genereerimise asemel kasutada näiteks CMD-failide genereerimist, mis avavad tehes brauseris SAP GUI akna. Allpool toome näite (sapguicmd.php) SAP GUI otse käivitamiseks koos täieliku ühenduse rea määramisega, ilma et oleks vaja seadistatud SAP Logon’i:

<?php
$queries = array();
parse_str($_SERVER['QUERY_STRING'], $queries);
$Title = $queries['Title'];
$ROUTER = $queries['ROUTER'];
$ROUTERPORT = $queries['ROUTERPORT'];
$HOST = $queries['HOST'];
$PORT = $queries['PORT'];
$MESS = $queries['MESS'];
$LG = $queries['LG'];
$filename = 'SAPGUI_';
if($MESS'') $filename = $filename.$MESS;
if($HOST'') $filename = $filename.$HOST;
if($PORT'') $filename = $filename.'_'.$PORT;
$filename = $filename.'.cmd';
header('Content-disposition: attachment; filename='.$filename);
header('Content-type: application/cmd');
echo "@echo offrn";
echo "chcp 1251rn";
echo "echo Sisenemine ".$Title."rn";
echo "set SAP_CODEPAGE=1504rn";
echo 'if exist "%ProgramFiles(x86)%SAPFrontEndSapGuisapgui.exe" set gui=%ProgramFiles(x86)%SAPFrontEndSapGuisapgui.exe'."rn";
echo 'if exist "%ProgramFiles%SAPFrontEndSapGuisapgui.exe" set gui=%ProgramFiles%SAPFrontEndSapGuisapgui.exe'."rn";
echo "set logon=";
if($ROUTER'') echo "\/H\/".$ROUTER;
if($ROUTERPORT'') echo "\/S\/".$ROUTERPORT;
if($MESS'') echo "\/M\/".$MESS;
if($HOST'') echo "\/H\/".$HOST;
if($PORT'') echo "\/S\/".$PORT;
if($LG'') echo "\/G\/".$LG;
echo "rn";
echo '"%gui%" %logon%'."rn";
?>

Allikas: habr.com

SAP GUI avamine brauserist