ILIAS  release_8 Revision v8.19
All Data Structures Namespaces Files Functions Variables Modules Pages
ilAuthSession Class Reference
+ Collaboration diagram for ilAuthSession:

Public Member Functions

 init ()
 Start auth session. More...
 
 isValid ()
 Check if current session is valid (authenticated and not expired) More...
 
 regenerateId ()
 Regenerate id. More...
 
 logout ()
 Logout user => stop session. More...
 
 isAuthenticated ()
 Check if session is authenticated. More...
 
 setAuthenticated (bool $a_status, int $a_user_id)
 Set authenticated. More...
 
 isExpired ()
 Check if current is or was expired in last request. More...
 
 setExpired (bool $a_status)
 Set session expired. More...
 
 setUserId (int $a_id)
 Set authenticated user id. More...
 
 getUserId ()
 Get authenticated user id. More...
 
 getId ()
 get session id More...
 

Static Public Member Functions

static getInstance (\ilLogger $logger)
 Get instance. More...
 

Protected Member Functions

 getLogger ()
 
 validateExpiration ()
 Check expired value of session. More...
 
 setId (string $a_id)
 Set id. More...
 

Private Member Functions

 __construct (\ilLogger $logger)
 

Private Attributes

const SESSION_AUTH_AUTHENTICATED = '_authsession_authenticated'
 
const SESSION_AUTH_USER_ID = '_authsession_user_id'
 
const SESSION_AUTH_EXPIRED = '_authsession_expired'
 
ilLogger $logger
 
string $id = ''
 
int $user_id = 0
 
bool $expired = false
 
bool $authenticated = false
 

Static Private Attributes

static ilAuthSession $instance = null
 

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

ilAuthSession::__construct ( \ilLogger  $logger)
private

Definition at line 39 of file class.ilAuthSession.php.

References $logger, and ILIAS\Repository\logger().

40  {
41  $this->logger = $logger;
42  }
+ Here is the call graph for this function:

Member Function Documentation

◆ getId()

ilAuthSession::getId ( )

get session id

Definition at line 208 of file class.ilAuthSession.php.

References $id.

Referenced by regenerateId(), and validateExpiration().

208  : string
209  {
210  return $this->id;
211  }
+ Here is the caller graph for this function:

◆ getInstance()

static ilAuthSession::getInstance ( \ilLogger  $logger)
static

Get instance.

Parameters

Definition at line 49 of file class.ilAuthSession.php.

References $logger.

Referenced by ilInitialisation\initSession().

50  {
51  if (self::$instance) {
52  return self::$instance;
53  }
54  return self::$instance = new self($logger);
55  }
+ Here is the caller graph for this function:

◆ getLogger()

ilAuthSession::getLogger ( )
protected
Returns
ilLogger

Definition at line 60 of file class.ilAuthSession.php.

References $logger.

Referenced by init(), logout(), and regenerateId().

60  : ilLogger
61  {
62  return $this->logger;
63  }
+ Here is the caller graph for this function:

◆ getUserId()

ilAuthSession::getUserId ( )

Get authenticated user id.

Definition at line 175 of file class.ilAuthSession.php.

References $user_id.

Referenced by logout(), and ilAuthFrontend\migrateAccount().

175  : int
176  {
177  return $this->user_id;
178  }
+ Here is the caller graph for this function:

◆ init()

ilAuthSession::init ( )

Start auth session.

Definition at line 68 of file class.ilAuthSession.php.

References ANONYMOUS_USER_ID, ilSession\get(), getLogger(), ILIAS\Repository\int(), setId(), setUserId(), and validateExpiration().

Referenced by logout().

68  : bool
69  {
70  session_start();
71 
72  $this->setId(session_id());
73 
74  $user_id = (int) ilSession::get(self::SESSION_AUTH_USER_ID);
75 
76  if ($user_id) {
77  $this->getLogger()->debug('Resuming old session for user: ' . $user_id);
78  $this->setUserId((int) ilSession::get(self::SESSION_AUTH_USER_ID));
79  $this->expired = (bool) ilSession::get(self::SESSION_AUTH_EXPIRED);
80  $this->authenticated = (bool) ilSession::get(self::SESSION_AUTH_AUTHENTICATED);
81 
82  $this->validateExpiration();
83  } else {
84  $this->getLogger()->debug('Started new session.');
86  $this->expired = false;
87  $this->authenticated = false;
88  }
89  return true;
90  }
static get(string $a_var)
setUserId(int $a_id)
Set authenticated user id.
const ANONYMOUS_USER_ID
Definition: constants.php:27
validateExpiration()
Check expired value of session.
setId(string $a_id)
Set id.
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ isAuthenticated()

ilAuthSession::isAuthenticated ( )

Check if session is authenticated.

Definition at line 127 of file class.ilAuthSession.php.

References $authenticated.

Referenced by isValid(), and ilAuthFrontend\migrateAccount().

127  : bool
128  {
129  return $this->authenticated;
130  }
+ Here is the caller graph for this function:

◆ isExpired()

ilAuthSession::isExpired ( )

Check if current is or was expired in last request.

Definition at line 150 of file class.ilAuthSession.php.

References $expired.

Referenced by isValid(), and validateExpiration().

150  : bool
151  {
152  return $this->expired;
153  }
+ Here is the caller graph for this function:

◆ isValid()

ilAuthSession::isValid ( )

Check if current session is valid (authenticated and not expired)

Definition at line 95 of file class.ilAuthSession.php.

References isAuthenticated(), and isExpired().

95  : bool
96  {
97  return !$this->isExpired() && $this->isAuthenticated();
98  }
isExpired()
Check if current is or was expired in last request.
isAuthenticated()
Check if session is authenticated.
+ Here is the call graph for this function:

◆ logout()

ilAuthSession::logout ( )

Logout user => stop session.

Definition at line 114 of file class.ilAuthSession.php.

References ANONYMOUS_USER_ID, getLogger(), getUserId(), init(), and setAuthenticated().

Referenced by ilSessionControl\checkCurrentSessionIsAllowed().

114  : void
115  {
116  $this->getLogger()->debug('Logout called for: ' . $this->getUserId());
117  session_regenerate_id(true);
118  session_destroy();
119 
120  $this->init();
121  $this->setAuthenticated(true, ANONYMOUS_USER_ID);
122  }
const ANONYMOUS_USER_ID
Definition: constants.php:27
getUserId()
Get authenticated user id.
init()
Start auth session.
setAuthenticated(bool $a_status, int $a_user_id)
Set authenticated.
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ regenerateId()

ilAuthSession::regenerateId ( )

Regenerate id.

Definition at line 103 of file class.ilAuthSession.php.

References getId(), getLogger(), and setId().

Referenced by setAuthenticated().

103  : void
104  {
105  $old_session_id = session_id();
106  session_regenerate_id(true);
107  $this->setId(session_id());
108  $this->getLogger()->info('Session regenerate id: [' . substr($old_session_id, 0, 5) . '] -> [' . substr($this->getId(), 0, 5) . ']');
109  }
getId()
get session id
setId(string $a_id)
Set id.
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ setAuthenticated()

ilAuthSession::setAuthenticated ( bool  $a_status,
int  $a_user_id 
)

Set authenticated.

Definition at line 135 of file class.ilAuthSession.php.

References regenerateId(), ilSession\set(), and setExpired().

Referenced by logout().

135  : void
136  {
137  $this->authenticated = $a_status;
138  $this->user_id = $a_user_id;
139  ilSession::set(self::SESSION_AUTH_AUTHENTICATED, $a_status);
140  ilSession::set(self::SESSION_AUTH_USER_ID, $a_user_id);
141  $this->setExpired(false);
142  if ($a_status) {
143  $this->regenerateId();
144  }
145  }
regenerateId()
Regenerate id.
setExpired(bool $a_status)
Set session expired.
static set(string $a_var, $a_val)
Set a value.
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ setExpired()

ilAuthSession::setExpired ( bool  $a_status)

Set session expired.

Definition at line 158 of file class.ilAuthSession.php.

References ilSession\set().

Referenced by setAuthenticated(), and validateExpiration().

158  : void
159  {
160  $this->expired = $a_status;
161  ilSession::set(self::SESSION_AUTH_EXPIRED, (int) $a_status);
162  }
static set(string $a_var, $a_val)
Set a value.
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ setId()

ilAuthSession::setId ( string  $a_id)
protected

Set id.

Definition at line 200 of file class.ilAuthSession.php.

Referenced by init(), and regenerateId().

200  : void
201  {
202  $this->id = $a_id;
203  }
+ Here is the caller graph for this function:

◆ setUserId()

ilAuthSession::setUserId ( int  $a_id)

Set authenticated user id.

Definition at line 167 of file class.ilAuthSession.php.

Referenced by init().

167  : void
168  {
169  $this->user_id = $a_id;
170  }
+ Here is the caller graph for this function:

◆ validateExpiration()

ilAuthSession::validateExpiration ( )
protected

Check expired value of session.

Definition at line 183 of file class.ilAuthSession.php.

References getId(), isExpired(), ilSession\lookupExpireTime(), and setExpired().

Referenced by init().

183  : bool
184  {
185  if ($this->isExpired()) {
186  // keep status
187  return false;
188  }
189 
190  if (time() > ilSession::lookupExpireTime($this->getId())) {
191  $this->setExpired(true);
192  return false;
193  }
194  return true;
195  }
isExpired()
Check if current is or was expired in last request.
static lookupExpireTime(string $a_session_id)
Lookup expire time for a specific session.
setExpired(bool $a_status)
Set session expired.
getId()
get session id
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

Field Documentation

◆ $authenticated

bool ilAuthSession::$authenticated = false
private

Definition at line 37 of file class.ilAuthSession.php.

Referenced by isAuthenticated().

◆ $expired

bool ilAuthSession::$expired = false
private

Definition at line 36 of file class.ilAuthSession.php.

Referenced by isExpired().

◆ $id

string ilAuthSession::$id = ''
private

Definition at line 34 of file class.ilAuthSession.php.

Referenced by getId().

◆ $instance

ilAuthSession ilAuthSession::$instance = null
staticprivate

Definition at line 30 of file class.ilAuthSession.php.

◆ $logger

ilLogger ilAuthSession::$logger
private

Definition at line 32 of file class.ilAuthSession.php.

Referenced by __construct(), getInstance(), and getLogger().

◆ $user_id

int ilAuthSession::$user_id = 0
private

Definition at line 35 of file class.ilAuthSession.php.

Referenced by getUserId().

◆ SESSION_AUTH_AUTHENTICATED

const ilAuthSession::SESSION_AUTH_AUTHENTICATED = '_authsession_authenticated'
private

Definition at line 26 of file class.ilAuthSession.php.

◆ SESSION_AUTH_EXPIRED

const ilAuthSession::SESSION_AUTH_EXPIRED = '_authsession_expired'
private

Definition at line 28 of file class.ilAuthSession.php.

◆ SESSION_AUTH_USER_ID

const ilAuthSession::SESSION_AUTH_USER_ID = '_authsession_user_id'
private

Definition at line 27 of file class.ilAuthSession.php.


The documentation for this class was generated from the following file: