OpenSCADAWiki: Doc/API/part10 ...

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

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

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

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

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

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

• void subLoad( ); -- Çàãðóçêà ïîäñèñòåìû.
• void subSave( ); -- Ñîõðàíåíèå ïîäñèñòåìû.
• bool access( const string &user, char mode, int owner, int group, int access ); -- Ïðîâåðêà äîñòóïà äëÿ ïîëüçîâàòåëÿ <user> ñ ïðàâàìè <mode> ê ðåñóðñó ñ âëàäåëüöåì <owner> è ãðóïïîé <access>.
• string usr( int id ); -- Èìÿ ïîëüçîâàòåëÿ â ñîîòâåòñòâèè ñ èäåíòèôèêàòîðîì <id>.
• int usr( const string &sid ); -- Èäåíòèôèêàòîð ïîëüçîâàòåëÿ <sid>.
• void usrList( vector<string> &list ); -- Ñïèñîê ïîëüçîâàòåëåé <list>.
• bool usrPresent( const string &name ); -- Ïðîâåðêà íà íàëè÷èå óêàçàííîãî ïîëüçîâàòåëÿ <name>.
• int usrAdd( const string &name, const string &idb = "*.*" ); -- Äîáàâëåíèå ïîëüçîâàòåëÿ <name> ñ õðàíåíèåì â ÁÄ <idb>.
• void usrDel( const string &name ); -- Óäàëåíèå ïîëüçîâàòåëÿ <name>.
• AutoHD<TUser> usrAt( const string &name ); -- Ïîäêëþ÷åíèå ê ïîëüçîâàòåëþ <name>.
• string grp( int id ); -- Èìÿ ãðóïïû ïîëüçîâàòåëåé â ñîîòâåòñòâèè ñ èäåíòèôèêàòîðîì <id>.
• int grp( const string &sid ); -- Èäåíòèôèêàòîð ãðóïïû ïîëüçîâàòåëåé <sid>.
• void grpList( vector<string> &list ); -- Ñïèñîê ãðóïï ïîëüçîâàòåëåé <list>.
• bool grpPresent( const string &name ); -- Ïðîâåðêà íà íàëè÷èå óêàçàííîé ãðóïïû ïîëüçîâàòåëåé <name>.
• int grpAdd( const string &name, const string &idb = "*.*" ); -- Äîáàâëåíèå ãðóïïû ïîëüçîâàòåëåé <name> ñ õðàíåíèåì â ÁÄ <idb>.
• void grpDel( const string &name ); -- Óäàëåíèå ãðóïïû ïîëüçîâàòåëåé <name>.
• AutoHD<TGroup> grpAt( const string &name ); -- Ïîäêëþ÷åíèå ê ãðóïïå ïîëüçîâàòåëåé <name>.
• string optDescr( ); -- Ëîêàëèçîâàííàÿ ïîìîùü ïî îïöèÿì êîìàíäíîé ñòðîêè è ïàðàìåòðàì êîíôèãóðàöèîííîãî ôàéëà.

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

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

• TUser( const string &name, const string &idb, unsigned id, TElem *el ); -- Èíèöèàëèçèðóþùèé êîíñòðóêòîð.
• const string &name(); -- Èìÿ ïîëüçîâàòåëÿ.
• const string &lName(); -- Ïîëíîå èìÿ ïîëüçîâàòåëÿ.
• const int &id(); -- Èäåíòèôèêàòîð ïîëüçîâàòåëÿ.
• const string &grp(); -- Îñíîâíàÿ ãðóïïà ïîëüçîâàòåëÿ.
• bool auth( const string &n_pass ); -- Ïðîâåðêà àóòåíòè÷íîñòè ïîëüçîâàòåëÿ ïî ïàðîëþ <n_pass>.
• void name( const string &nm ); -- Óñòàíîâêà èìåíè ïîëüçîâàòåëÿ <nm>.
• void lName( const string &nm ); -- Óñòàíîâêà ïîëíîãî èìåíè ïîëüçîâàòåëÿ <nm>.
• void id( unsigned n_id ); -- Óñòàíîâêà èäåíòèôèêàòîðà ïîëüçîâàòåëÿ <n_id>.
• void pass( const string &n_pass ); -- Óñòàíîâêà ïàðîëÿ ïîëüçîâàòåëÿ <n_pass>.
• void grp( const string &nm_grp ); -- Óñòàíîâêà îñíîâíîé ãðóïïû ïîëüçîâàòåëÿ <nm_grp>.
• void load(); -- Çàãðóçêà ïîëüçîâàòåëÿ.
• void save(); -- Ñîõðàíåíèå ïîëüçîâàòåëÿ.
• string BD(); -- Ïîëíîå èìÿ òàáëèöû ÁÄ õðàíÿùåé ïîëüçîâàòåëÿ.
• TSeñurity &owner(); -- Ïîäñèñòåìà «Áåçîïàñíîñòü» - âëàäåëåö ïîëüçîâàòåëÿ.

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

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

• TGroup( const string &name, const string &idb, unsigned id, TElem *el ); -- Èíèöèàëèçèðóþùèé êîíñòðóêòîð.
• const string &name(); -- Èìÿ ãðóïïû ïîëüçîâàòåëåé.
• const string &lName(); -- Ïîëíîå èìÿ ãðóïïû ïîëüçîâàòåëåé.
• const int &id(); -- Èäåíòèôèêàòîð ãðóïïû ïîëüçîâàòåëåé.
• void name( const string &nm ); -- Óñòàíîâêà èìåíè ãðóïïû ïîëüçîâàòåëåé <nm>.
• void lName( const string &nm ); -- Óñòàíîâêà ïîëíîãî èìåíè ãðóïïû ïîëüçîâàòåëåé <nm>.
• void id( unsigned n_id ); -- Óñòàíîâêà èäåíòèôèêàòîðà ãðóïïû ïîëüçîâàòåëåé <n_id>.
• bool user( const string &name ); -- Ïðîâåðêà íà ïðèíàäëåæíîñòü ïîëüçîâàòåëÿ ê ãðóïïå <name>.
• void load(); -- Çàãðóçêà ïîëüçîâàòåëÿ.
• void save(); -- Ñîõðàíåíèå ïîëüçîâàòåëÿ.
• string BD(); -- Ïîëíîå èìÿ òàáëèöû ÁÄ õðàíÿùåé ãðóïïó ïîëüçîâàòåëåé.
• TSeñurity &owner(); -- Ïîäñèñòåìà «Áåçîïàñíîñòü» - âëàäåëåö ãðóïïîé ïîëüçîâàòåëåé.