:py:mod:`dissect.target.plugins.apps.webhosting.cpanel`
=======================================================

.. py:module:: dissect.target.plugins.apps.webhosting.cpanel




Module Contents
---------------

Classes
~~~~~~~

.. autoapisummary::

   dissect.target.plugins.apps.webhosting.cpanel.CPanelPlugin




Attributes
~~~~~~~~~~

.. autoapisummary::

   dissect.target.plugins.apps.webhosting.cpanel.CPanelLastloginRecord
   dissect.target.plugins.apps.webhosting.cpanel.CPANEL_LASTLOGIN
   dissect.target.plugins.apps.webhosting.cpanel.CPANEL_LOGS_PATH
   dissect.target.plugins.apps.webhosting.cpanel.CPANEL_LASTLOGIN_PATTERN


.. py:data:: CPanelLastloginRecord

.. py:data:: CPANEL_LASTLOGIN
   :value: '.lastlogin'


.. py:data:: CPANEL_LOGS_PATH
   :value: '/usr/local/cpanel/logs'


.. py:data:: CPANEL_LASTLOGIN_PATTERN

.. py:class:: CPanelPlugin(target: dissect.target.target.Target)

   Bases: :py:obj:`dissect.target.plugin.Plugin`


   cPanel webhosting plugin.


   .. py:attribute:: __namespace__
      :value: 'cpanel'


      Defines the plugin namespace.


   .. py:method:: check_compatible() -> None

      Perform a compatibility check with the target.

      This function should return ``None`` if the plugin is compatible with the current target (``self.target``).
      For example, check if a certain file exists. Otherwise it should raise an
      :class:`UnsupportedPluginError`.

      :raises UnsupportedPluginError: If the plugin could not be loaded.



   .. py:method:: lastlogin() -> collections.abc.Iterator[CPanelLastloginRecord]

      Return the content of the cPanel lastlogin file.

      The lastlogin files tracks successful cPanel interface logons. New logon events are only tracked
      if the IP-address of the logon changes.

      .. rubric:: References

      - https://forums.cpanel.net/threads/cpanel-control-panel-last-login-clarification.579221/
      - https://forums.cpanel.net/threads/lastlogin.707557/