OpenSCADAWiki: Doc/API/part10 ...

10. Ïîäñèñòåìà “Áåçîïàñíîñòü” (

Ïîäñèñòåìà áåçîïàñíîñòè ïðåäñòàâëåíà îáúåêòîì êîòîðûé ñîäåðæèò îáúåêòû ãðóïï TGroup è ïîëüçîâàòåëåé TUser.

Îáúåêò ïîëüçîâàòåëÿ TUser ñîäåðæèò ïîëüçîâàòåëüñêóþ èíôîðìàöèþ è âûïîëíÿåò ïðîâåðêó àóòåíòè÷íîñòè ïîëüçîâàòåëÿ â ñîîòâåòñòâèè ñ óêàçàííûì ïàðîëåì.

Îáúåêò ïîëüçîâàòåëÿ TGroup ñîäåðæèò èíôîðìàöèþ î ãðóïïå ïîëüçîâàòåëåé è âûïîëíÿåò ïðîâåðêó íà ïðèíàäëåæíîñòü ïîëüçîâàòåëÿ ê ãðóïïå.

10.1. Îáúåêò ïîäñèñòåìû «Áåçîïàñíîñòü» (

Ïóáëè÷íûå ìåòîäû:

• bool access( const string &user, char mode, int owner, int group, int access ); -- Ïðîâåðêà äîñòóïà äëÿ ïîëüçîâàòåëÿ <user> ñ ïðàâàìè <mode> ê ðåñóðñó ñ âëàäåëüöåì <owner> è ãðóïïîé <access>.
• void usrList( vector<string> &list ); -- Ñïèñîê ïîëüçîâàòåëåé <list>.
• void usrGrpList( const string &name, vector<string> &list ); -- Ñïèñîê ãðóïï ïîëüçîâàòåëåé <list>, â êîòîðûå ïîëüçîâàòåëü <name> âêëþ÷¸í.
• bool usrPresent( const string &name ); -- Ïðîâåðêà íà íàëè÷èå óêàçàííîãî ïîëüçîâàòåëÿ <name>.
• int usrAdd( const string &name, const string &db = "*.*" ); -- Äîáàâëåíèå ïîëüçîâàòåëÿ <name> ñ õðàíåíèåì â ÁÄ <db>.
• void usrDel( const string &name, bool complete = false ); -- Óäàëåíèå ïîëüçîâàòåëÿ <name> ñ âîçìîæíîñòüþ ïîëíîãî óäàëåíèÿ <complete>.
• AutoHD<TUser> usrAt( const string &name ); -- Ïîäêëþ÷åíèå ê ïîëüçîâàòåëþ <name>.
• void grpList( vector<string> &list ); -- Ñïèñîê ãðóïï ïîëüçîâàòåëåé <list>.
• bool grpPresent( const string &name ); -- Ïðîâåðêà íà íàëè÷èå óêàçàííîé ãðóïïû ïîëüçîâàòåëåé <name>.
• int grpAdd( const string &name, const string &db = "*.*" ); -- Äîáàâëåíèå ãðóïïû ïîëüçîâàòåëåé <name> ñ õðàíåíèåì â ÁÄ <db>.
• void grpDel( const string &name, bool complete = false ); -- Óäàëåíèå ãðóïïû ïîëüçîâàòåëåé <name> ñ âîçìîæíîñòüþ ïîëíîãî óäàëåíèÿ <complete>.
• AutoHD<TGroup> grpAt( const string &name ); -- Ïîäêëþ÷åíèå ê ãðóïïå ïîëüçîâàòåëåé <name>.

10.2. Îáúåêò ïîëüçîâàòåëÿ (TUser)

Ïóáëè÷íûå ìåòîäû:

• TUser( const string &name, const string &db, TElem *el ); -- Èíèöèàëèçèðóþùèé êîíñòðóêòîð.
• const string &name( ); -- Èìÿ ïîëüçîâàòåëÿ.
• const string &lName( ); -- Ïîëíîå èìÿ ïîëüçîâàòåëÿ.
• const string &picture( ); -- Èçîáðàæåíèå ïîëüçîâàòåëÿ.
• bool sysItem( ); -- Ïðèçíàê ñèñòåìíîãî ïîëüçîâàòåëÿ.
• bool auth( const string &pass ); -- Ïðîâåðêà àóòåíòè÷íîñòè ïîëüçîâàòåëÿ ïî ïàðîëþ <pass>.
• string DB( ); -- Àäðåñ ÁÄ ïîëüçîâàòåëÿ.
• string tbl( ); -- Àäðåñ òàáëèöû ÁÄ ïîëüçîâàòåëÿ.
• string fullDB( ); -- Ïîëíîå èìÿ òàáëèöû ÁÄ ïîëüçîâàòåëÿ.
• void setLName( const string &nm ); -- Óñòàíîâêà ïîëíîãî èìåíè ïîëüçîâàòåëÿ â <nm>.
• void setPicture( const string &pct ); -- Óñòàíîâêà èçîáðàæåíèÿ ïîëüçîâàòåëÿ â <pct>.
• void setPass( const string &pass ); -- Óñòàíîâêà ïàðîëÿ ïîëüçîâàòåëÿ â <pass>.
• void setSysItem( bool vl ); -- Óñòàíîâèòü ïðèçíàê ñèñòåìíîãî ïîëüçîâàòåëÿ â <vl>.
• void setDB( const string &vl ); -- Óñòàíîâêà àäðåñà ÁÄ ïîëüçîâàòåëÿ.
• TSeñurity &owner( ); -- Ïîäñèñòåìà «Áåçîïàñíîñòü» - âëàäåëåö ïîëüçîâàòåëÿ.

10.3. Îáúåêò ãðóïïû ïîëüçîâàòåëåé (TGroup)

Ïóáëè÷íûå ìåòîäû:

• TGroup( const string &name, const string &db, TElem *el ); -- Èíèöèàëèçèðóþùèé êîíñòðóêòîð.
• const string &name( ); -- Èìÿ ãðóïïû ïîëüçîâàòåëåé.
• const string &lName( ); -- Ïîëíîå èìÿ ãðóïïû ïîëüçîâàòåëåé.
• bool sysItem( ); -- Ïðèçíàê ñèñòåìíîãî ïîëüçîâàòåëÿ.
• string DB( ); -- Àäðåñ ÁÄ ãðóïïû ïîëüçîâàòåëåé.
• string tbl( ); -- Àäðåñ òàáëèöû ÁÄ ãðóïïû ïîëüçîâàòåëåé.
• string fullDB( ); -- Ïîëíîå èìÿ òàáëèöû ÁÄ ãðóïïû ïîëüçîâàòåëåé.
• void setLName( const string &nm ); -- Óñòàíîâêà ïîëíîãî èìåíè ãðóïïû ïîëüçîâàòåëåé â <nm>.
• void setSysItem( bool vl ); -- Óñòàíîâèòü ïðèçíàê ñèñòåìíîãî ïîëüçîâàòåëÿ â <vl>.
• void setDB( const string &vl ); -- Óñòàíîâêà àäðåñà ÁÄ ãðóïïû ïîëüçîâàòåëåé.
• bool user( const string &name ); -- Ïðîâåðêà íà ïðèíàäëåæíîñòü ïîëüçîâàòåëÿ ê ãðóïïå <name>.
• void userAdd( const string &name ); -- Äîáàâëåíèå ïîëüçîâàòåëÿ <name> â ãðóïïó.
• void userDel( const string &name ); -- Óäàëåíèå ïîëüçîâàòåëÿ <name> èç ãðóïïû.
• TSeñurity &owner( ); -- Ïîäñèñòåìà «Áåçîïàñíîñòü» - âëàäåëåö ãðóïïû ïîëüçîâàòåëåé.