Skip to content

Updated #617

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
harneshalaka wants to merge 1 commit into
base: main
Choose a base branch
from
Open

Updated #617

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 14 additions & 0 deletions DC-SLES-PAM-security.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,14 @@
# This file originates from the project https://github.com/openSUSE/doc-kit
# This file can be edited downstream.

MAIN="pam.asm.xml"
SRC_DIR="articles"
IMG_SRC_DIR="images"

PROFOS="slmicro"
PROFCONDITION="suse-product"
#PROFCONDITION="suse-product;beta"
#PROFCONDITION="community-project"

STYLEROOT="/usr/share/xml/docbook/stylesheet/suse2022-ns"
FALLBACK_STYLEROOT="/usr/share/xml/docbook/stylesheet/suse-ns"
170 changes: 168 additions & 2 deletions articles/pam.asm.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -65,11 +65,177 @@
</resource>
</resources>
<!-- S T R U C T U R E -->
<structure renderas="article" xml:id="pam-description" xml:lang="en">
<!-- S T R U C T U R E -->
<structure renderas="article" xml:id="sles-pam-description" xml:lang="en">
<merge>
<title>Authentication with PAM</title>
<!-- History -->
<revhistory xml:id="rh-pam-description">
<revhistory xml:id="rh-sles-pam-description">
<!-- Please set a suitable revision date! jjaeger -->
<revision><date>2025-12-05</date>
<revdescription>
<para>
Initial version
</para>
</revdescription>
</revision>
</revhistory>
<!-- Maintainer -->
<meta name="maintainer" content="[email protected]" its:translate="no"/>
<!-- Architectures -->
<meta name="architecture" its:translate="no">
<phrase>&x86-64;</phrase>
<phrase>&power;</phrase>
<phrase>&ibm;</phrase>
<phrase>&aarch64;</phrase>
</meta>
<!-- Productname & Version -->
<meta name="productname" its:translate="no">
<productname version="16.0" os="sles;sles4sap">&productname;</productname>
</meta>
<!-- Search -->
<meta name="title" its:translate="yes">A description of PAM, its usage and configuration.</meta>
<meta name="description" its:translate="yes">PAM is used in the authentication process as a layer that mediates the access between the user and application.</meta>
<!-- Social Media -->
<meta name="social-descr" its:translate="yes">Learn how the PAM authentication mechanism works.</meta>
<!-- Task -->
<meta name="task" its:translate="no">
<phrase>Authentication</phrase>
<phrase>Security</phrase>
</meta>
<!-- Series -->
<meta name="series" its:translate="no">Products &amp; Solutions</meta>

<dm:docmanager xmlns:dm="urn:x-suse:ns:docmanager">
<dm:bugtracker>
<dm:url>https://bugzilla.suse.com/enter_bug.cgi</dm:url>
<dm:component>Documentation</dm:component>
<dm:product os="sles">SUSE Linux Enterprise Server 16.0</dm:product>
<dm:product os="sles4sap">SUSE Linux Enterprise Server 16.0</dm:product>
<dm:assignee>[email protected]</dm:assignee>
</dm:bugtracker>
<dm:translation>yes</dm:translation>
</dm:docmanager>
<abstract>
<variablelist>
<varlistentry>
<term>WHAT?</term>
<listitem>
<para>
Linux uses PAM (pluggable authentication modules) in the authentication
process as a layer that mediates between user and application. This article describes the PAM concept, structure of PAM configuration and usage of tools for configuring PAM.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>WHY?</term>
<listitem>
<para>
You want to know how to set up a PAM module and configure your system to use the U2F keys.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>EFFORT</term>
<listitem>
<para>
It takes approximately 20 minutes to read the article.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>REQUIREMENTS</term>
<listitem>
<itemizedlist>
<listitem>
<para>
To set up the authentication using the U2F keys, you need to have either YubiKeys or Security Keys.
</para>
</listitem>
</itemizedlist>
</listitem>
</varlistentry>
</variablelist>
</abstract>
</merge>
<!-- pull in all the topic files you need -->
<!-- pick the appropriate type of include to match your needs -->
<!-- pull in a topic as is -->
<!-- pull in a topic and switch the title -->
<module resourceref="_pam-about" renderas="section">
<merge>
<abstract>
<para/>
</abstract>
</merge>
</module>
<module resourceref="_pam-configuration" renderas="section">
<merge>
<abstract>
<para/>
</abstract>
</merge>
<module resourceref="_pam-sshd-configuration" renderas="section">
<merge>
<abstract>
<para/>
</abstract>
</merge>
</module>
</module>
<module resourceref="_pam-configuring-modules" renderas="section">
<merge>
<abstract>
<para/>
</abstract>
</merge>
</module>
<module resourceref="_pam-config-tool" renderas="section">
<merge>
<abstract>
<para/>
</abstract>
</merge>
</module>
<module resourceref="_pam-manual-configuration" renderas="section">
<merge>
<abstract>
<para/>
</abstract>
</merge>
</module>
<module resourceref="_pam-configuring-to-use-u2f" renderas="section">
<merge>
<abstract>
<para/>
</abstract>
</merge>
<module resourceref="_pam-associating-with-account" renderas="section">
<merge>
<abstract>
<para/>
</abstract>
</merge>
</module>
<module resourceref="_pam-update-configs" renderas="section">
<merge>
<abstract>
<para/>
</abstract>
</merge>
</module>
</module>

<module resourceref="_legal"/>
<module resourceref="_gfdl">
<output renderas="appendix"/>
</module>
</structure>
<structure renderas="article" xml:id="slmicro-pam-description" xml:lang="en">
<merge>
<title>Authentication with PAM</title>
<!-- History -->
<revhistory xml:id="rh-slmicro-pam-description">
<!-- Please set a suitable revision date! jjaeger -->
<revision><date>2025-11-04</date>
<revdescription>
Expand Down