OpenSCADAWiki: Home Page En/Doc/API/part10 ...

10. Subsystem “Security” (

Security subsystem is presented by an object TSesurity, which contains group objects of TGroup and users TUser.

User object TUser contains user information and checks the authenticity of the user in accordance with the specified password.

TGroup user object contains information about the group of users and checks the user's belonging to the group.

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( ); -- Ïîäñèñòåìà «Áåçîïàñíîñòü» - âëàäåëåö ãðóïïîé ïîëüçîâàòåëåé.