Compare commits

...
9 Commits
37 changed files with 1263 additions and 119 deletions

No files matched your search

+17 -10
View File
@@ -13,20 +13,27 @@ Ready-to-run bootstrap packages are published on the
## Authentication contract
1. The Windows tile collects a `DO`, `AL`, or `AD` institutional key and a password.
2. It sends that exact password over mutually authenticated TLS to the broker.
3. The broker validates the same key/password pair against the lightweight SGU
NTLM root. Only an authoritative `401`/`403` rejects the credential.
4. After successful authentication, the broker makes a separately bounded,
best-effort request for the minimum available SGU profile fields.
5. On success, the broker creates or moves the AD user, updates the available
name/mail/title/department/address metadata when available, and sets the AD password
to the exact submitted password.
6. The Credential Provider serializes the original `SecureString` to Windows.
1. Windows selects **Acceso Institucional** by default. The built-in
Microsoft password provider stays available for recovery.
2. Ordinary domain usernames go straight to Windows for Active Directory
authentication. A `DO`, `AL`, or `AD` key is checked against SGU first.
3. The tile sends recognized institutional keys and their exact passwords over
mutually authenticated TLS. After SGU accepts the credential, the broker
performs an idempotent Active Directory UPSERT: it creates or repairs the
account, role OU and group, supported profile fields, and AD password.
4. If SGU rejects the key or is unavailable, the unchanged credentials go to
Windows. Existing AD accounts can authenticate there; unknown or misspelled
accounts are rejected by Windows and are never created.
No derived password is created. Passwords are not written to a database, file,
event log, application log, command line, or response.
This makes Active Directory the only Windows sign-in account while preserving
automatic synchronization: if a person changes their institutional password,
the next successful Acceso Institucional sign-in updates the domain password
before Windows continues. A matching prefix alone never creates an account;
the institutional authority must first accept the submitted password.
For administrative accounts, profile enrichment first verifies the employee
number against the incident overview, then reads the structured given names and
surnames from `datos/personales.aspx` and the postal address from
Binary file not shown.

After

Width:  |  Height:  |  Size: 1.1 MiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.1 MiB

+32 -14
View File
@@ -52,15 +52,24 @@ Broker timeout, TLS failure, 429, or 5xx
-> only the last AD password succeeds
```
An explicit `400` or `401` from the broker is different: the provider displays
an error and does not serialize the rejected credential.
An explicit `400` or `401` from SGU does not create or update an account. The
tile submits the unchanged credentials to Windows, which accepts them only if
they match an existing Active Directory account.
## Account synchronization
The broker normalizes the username to uppercase and accepts exactly two letters
plus six digits. It searches `BaseDn` by `sAMAccountName`, creates the user when
absent, moves it to the mapped OU when required, sets `userPrincipalName`, and
passes the submitted password directly to ADSI `SetPassword`.
The visible Windows experience is one **Acceso Institucional** sign-in tile,
selected by default, with `Usuario` and `Contraseña`. Ordinary usernames go
straight to Windows for domain authentication. A `DO`, `AL`, or `AD` key is
checked by the broker against SGU. After SGU accepts the submitted password,
the broker searches `BaseDn` by `sAMAccountName`, creates the user when absent,
moves it to the mapped OU when required, sets `userPrincipalName`, and passes
that same password directly to ADSI `SetPassword`. This is an idempotent UPSERT
performed on every successful sign-in, so the next sign-in after an institutional
password change updates AD before Windows validates the interactive logon. If
SGU rejects the credential or is unavailable, the unchanged credentials go to
Windows; only an existing AD account can then authenticate. A matching username
pattern alone never provisions an account.
Before an account becomes usable, the broker applies explicit deny ACEs for the
Active Directory `Change Password` extended right to SELF and Everyone. Users
@@ -125,9 +134,10 @@ Windows client maps the group into its local **Remote Desktop Users** group.
Every synchronized user also receives `La Salle` in the AD
`company` attribute unless deployment configuration supplies another default.
The generic SGU credential is rendered as a dedicated branded tile instead of
being grouped below the anonymous **Other user** tile. Machine policy assigns
the SGU CLSID as the default provider, hides the last signed-in identity, and
The generic Acceso Institucional credential is rendered as a dedicated
branded tile instead of being grouped below the anonymous **Other user** tile.
Machine policy assigns
the provider CLSID as the default provider, hides the last signed-in identity, and
disables local-user enumeration while retaining the built-in Microsoft password
provider and its **Other user** recovery path. The computer GPO also applies
Windows' native default account picture to named Windows accounts; client
@@ -143,11 +153,19 @@ synthetic Windows account to imitate that title or ordering.
The managed hierarchy is rooted at `OU=Usuarios-SGU`: `Docentes`, `Alumnos`,
and `Administrativos` are direct child OUs beneath it. The domain GPO
`SGU - User session restrictions` is linked to this root and enables the
per-user `DisableLockWorkstation` policy and disables screen savers for the
complete hierarchy. The computer GPO `SGU - Windows client experience` is linked
to `OU=Laboratorio`; it suppresses first-logon/privacy/diagnostic prompts,
disables location, and enforces always-on display, sleep, and hibernation
settings for managed clients.
per-user `DisableLockWorkstation` and `DisableChangePassword` policies and
disables screen savers for the complete hierarchy. The enforced laboratory
loopback GPO also applies `DisableLockWorkstation` and disables screen savers
for domain accounts. Its computer-startup script runs as `LocalSystem` and
writes the same setting into every existing local profile and the Default
profile template, covering local accounts such as `ing`; it deliberately does
not apply `DisableChangePassword` to them. The computer GPO
`SGU - Windows client experience` is linked to `OU=Laboratorio`; it suppresses
first-logon/privacy/diagnostic prompts, disables location, and enforces
always-on display, sleep, and hibernation settings for managed clients. The
same computer GPO configures Edge with `HideFirstRunExperience=1`,
`BrowserSignin=0`, and `SyncDisabled=1`, so shared machines do not show consumer
onboarding or permit personal browser sign-in and cloud synchronization.
That computer GPO also owns the base lock-screen image and a per-logon command
for the personalized desktop wallpaper. The client-side renderer reads the
+16 -4
View File
@@ -187,9 +187,18 @@ pantalla, suspensión, hibernación y suspensión híbrida, conectado a corrient
batería. El guard de enrolamiento vuelve a aplicar `powercfg /hibernate off` y
los tiempos en cero al inicio y diariamente.
El enrollment de Windows también aplica `DisableLockWorkstation=1` a **todos
los perfiles locales existentes** y a la plantilla `C:\Users\Default`. El
trabajo se ejecuta una sola vez como `LocalSystem` y termina; no deja una tarea
programada. La GPO de Laboratorio repite la misma operación como script de
inicio de equipo para que un cliente ya unido, o una cuenta local creada
después, también reciba la restricción.
Esa GPO también ejecuta el generador local del fondo de bienvenida y aplica el
fondo azul base a la pantalla de bloqueo. El fondo individual se crea al abrir la
sesión con el nombre del usuario y `location`/OU del equipo; véase
sesión con el nombre del usuario y `location`/OU del equipo. Los alumnos conservan
la base azul; `SGU-Administrativos` recibe la variante gris oscuro y
`SGU-Docentes` la variante rojo vino. Véase
[welcome-wallpaper.md](welcome-wallpaper.md).
`HideEULAPage` no forma parte de esta GPO: es una opción de archivo Unattend para
@@ -223,12 +232,15 @@ administradores.
El proveedor usa un mosaico genérico dedicado, no una credencial asociada al SID
anónimo de **Other user**. Windows muestra la imagen institucional y la etiqueta
`La Salle · Acceso SGU`; el encabezado `Acceso institucional SGU`
se publica como `CPFT_LARGE_TEXT` solamente en el mosaico seleccionado. LogonUI
`Acceso Institucional`; el encabezado `Iniciar sesión` se publica como
`CPFT_LARGE_TEXT` solamente en el mosaico seleccionado. El instalador selecciona
ese proveedor por defecto. Los usuarios de dominio se validan contra Active
Directory; las claves institucionales aceptadas por SGU hacen el UPSERT en AD
desde ese mismo mosaico. LogonUI
elige la familia, el peso y el tamaño final y no expone opciones de tipografía a
un Credential Provider.
La configuración soportada garantiza que SGU queda seleccionado por defecto y
La configuración soportada garantiza que Acceso Institucional queda seleccionado por defecto y
que no se conserva el último usuario. El orden vertical exacto de mosaicos lo
decide LogonUI y no tiene una directiva pública. Por seguridad no se filtra ni
se elimina **Other user**: Microsoft recomienda conservar al menos un proveedor
+1 -1
View File
@@ -136,7 +136,7 @@ On Windows 10:
```
Use Lithnet's `Invoke-CredUI` test utility when available, or sign out/restart
the VM and select **Acceso institucional SGU**. Keep the built-in Windows
the VM and select **Acceso Institucional**. Keep the built-in Windows
password provider available through **Other user**.
On the domain controller, apply the SGU user and computer policies once:
+17 -6
View File
@@ -1,8 +1,11 @@
# Protección del fondo de escritorio en Laboratorio
# Protección del fondo y de sesión en Laboratorio
El bootstrap de servidor publica `SGU - Laboratorio wallpaper protection` en
`OU=Laboratorio` y sus OU hijas. Para actualizar un dominio existente sin volver
a ejecutar el bootstrap, ejecute en el DC con permisos para administrar GPO:
`OU=Laboratorio` y sus OU hijas. Además de proteger el fondo, impide bloquear
la estación a **toda cuenta que abra sesión en esas máquinas**, incluidas las
cuentas locales como `ing`; no modifica las reglas independientes de cambio de
contraseña de Usuarios-SGU. Para actualizar un dominio existente sin volver a
ejecutar el bootstrap, ejecute en el DC con permisos para administrar GPO:
```powershell
.\scripts\Set-SguLaboratorioWallpaperPolicy.ps1 `
@@ -14,8 +17,15 @@ los valores escritos. Admite `-WhatIf`. El vínculo está habilitado y forzado,
prioridad 1, para que también alcance las OU hijas con herencia bloqueada.
- Loopback **Merge** aplica las opciones de usuario según la OU de la computadora
y conserva las otras políticas del usuario.
y conserva las otras políticas del usuario. Para no depender de que Windows
procese una GPO de usuario para una cuenta local, la GPO también instala un
script de **inicio de equipo** que corre como `LocalSystem`: escribe la regla
en cada perfil local existente y en `C:\Users\Default\NTUSER.DAT`. Así `ing`,
`alumno` y cualquier cuenta local nueva reciben `DisableLockWorkstation=1`.
- `NoChangingWallPaper=1` bloquea el cambio desde Personalización.
- `DisableLockWorkstation=1` deshabilita Win+L y la opción **Bloquear** para
todos esos usuarios; `ScreenSaveActive=0` evita que un protector de pantalla
cree una sesión bloqueada indirectamente.
- `Wallpaper` fija el archivo generado por SGU:
`%LOCALAPPDATA%\SGU\Wallpapers\welcome-%COMPUTERNAME%.jpg`, con estilo Fill.
@@ -25,8 +35,9 @@ de inicio de sesión. No aplica a Linux. Es una restricción de la interfaz de
Windows, no una barrera contra administradores ni contra la modificación directa
del JPG, que está dentro del perfil del usuario.
Tras actualizar las políticas del equipo, cierre e inicie sesión para procesar
loopback y comprobar la política de usuario con `gpresult /h resultado.html`.
Tras actualizar las políticas del equipo, reinicie el equipo o ejecute de nuevo
el enrollment para procesar el script de perfiles locales. Después, cierre e
inicie sesión para comprobar la política de usuario con `gpresult /h resultado.html`.
Compruebe también visualmente el fondo y Personalización en una sesión de dominio.
La validación por WinRM no sustituye esa prueba de escritorio interactivo.
+16
View File
@@ -0,0 +1,16 @@
# SGU Credential Provider 0.6.10
Esta versión administra Microsoft Edge en los equipos Windows del laboratorio.
- `HideFirstRunExperience=1` omite la experiencia de primera ejecución y la
pantalla de presentación.
- `BrowserSignin=0` impide iniciar sesión en Edge con cuentas personales o de
organización.
- `SyncDisabled=1` deshabilita Microsoft Sync y su solicitud de consentimiento.
- Las tres configuraciones se publican como valores obligatorios de equipo en
`SGU - Windows client experience`, vinculada a `OU=Laboratorio`.
Las directivas se escriben directamente en
`HKLM\Software\Policies\Microsoft\Edge`; las plantillas `MSEdge.admx` sólo son
necesarias para editarlas mediante la interfaz de Administrative Templates, no
para su aplicación.
+25
View File
@@ -0,0 +1,25 @@
# SGU Credential Provider 0.6.11
## Fondos por rol
- Alumnos y cuentas sin rol conservan el fondo azul institucional.
- `SGU-Administrativos` recibe la base gris oscuro con el logo institucional.
- `SGU-Docentes` recibe la base rojo vino con el logo institucional.
- Windows selecciona la base desde los grupos del token de inicio de sesión; Linux
usa las pertenencias que expone SSSD. No se almacenan roles ni contraseñas
adicionales.
- Si hay una pertenencia ambigua o falta una base, se usa el fondo azul y queda
un aviso de diagnóstico, sin retrasar el inicio de sesión.
## Sesiones de laboratorio
- La GPO aplicada por equipo en `OU=Laboratorio` mantiene loopback Merge y ahora
escribe `DisableLockWorkstation=1` para cualquier usuario que inicie sesión en
esas computadoras, incluso una cuenta local como `ing`.
- También deshabilita el protector de pantalla para evitar un bloqueo indirecto.
La regla no impide el cambio de contraseña de cuentas locales: esa restricción
continúa limitada a `OU=Usuarios-SGU` y al Auth Broker.
Los paquetes Windows, Linux y de servidor incluyen las tres bases y la política
actualizada. Después de aplicar la GPO en un cliente existente, cierre e inicie
sesión para que el contexto del usuario procese loopback.
+17
View File
@@ -0,0 +1,17 @@
# SGU Credential Provider 0.6.12
Esta corrección hace que la restricción **No bloquear estación de trabajo** sea
efectiva también para cuentas locales de equipos Windows del Laboratorio.
- Durante el enrollment y su reparación, se ejecuta un trabajador temporal como
`LocalSystem` que fija `DisableLockWorkstation=1` en cada perfil local
existente y en `C:\Users\Default\NTUSER.DAT`.
- La GPO `SGU - Laboratorio wallpaper protection` instala el mismo código como
script de inicio de equipo. Esto alcanza máquinas ya unidas al dominio en su
siguiente arranque, incluso si sólo se usa una cuenta local como `ing`.
- El script de inicio usa un lanzador `cmd` con PowerShell en modo Bypass para
no depender de la política de ejecución local. El enrollment no deja una
tarea programada permanente.
Los usuarios de dominio siguen recibiendo la directiva por su GPO de usuario y
por loopback. Esta versión sólo corrige la cobertura de perfiles locales.
+15
View File
@@ -0,0 +1,15 @@
# SGU Credential Provider 0.6.13
La pantalla de inicio de sesión ahora presenta una sola credencial visible:
**La Salle**, con los campos `Usuario` y `Contraseña`. Ya no muestra el texto
“Acceso Institucional SGU”.
La autenticación institucional permanece dentro del broker, sin una segunda
captura. Después de cada autenticación válida, el broker ejecuta su UPSERT de
Active Directory: crea o repara la cuenta, la OU, el grupo, los datos de perfil
disponibles y la contraseña de AD. Así, la siguiente sesión después de cambiar
una contraseña institucional sincroniza esa contraseña con el dominio.
El patrón `DO`, `AL` o `AD` con seis dígitos continúa siendo sólo un formato de
usuario. No autoriza ni crea cuentas por sí mismo: la autoridad institucional
debe validar la contraseña antes de que el UPSERT haga cambios en AD.
+18
View File
@@ -0,0 +1,18 @@
# SGU Credential Provider 0.6.14
El mosaico predeterminado se llama **Acceso Institucional**. En él se pueden
usar tanto cuentas existentes de Active Directory como claves institucionales
DO, AL y AD:
- Los usuarios de dominio que no son claves institucionales se envían
directamente a Windows para validación por Active Directory.
- Las claves institucionales se validan primero contra SGU. Si SGU las acepta,
el broker enriquece o actualiza la cuenta y sincroniza la contraseña con AD.
- Si SGU rechaza la clave o no está disponible, Windows valida la credencial
existente contra AD o las credenciales de dominio guardadas en caché. Una
cuenta inexistente no se crea sin una validación SGU correcta.
- El instalador y la GPO seleccionan **Acceso Institucional** como predeterminado
y conservan el proveedor de contraseña de Microsoft para recuperación.
El mosaico recopila el usuario y la contraseña una sola vez. La contraseña no
se deriva ni se guarda en un archivo, base de datos o registro.
+8 -6
View File
@@ -87,13 +87,15 @@ Use an enterprise CA with revocation checking in production.
## Recovery and availability
The provider distinguishes an authoritative rejection from unavailable
infrastructure:
The provider distinguishes an SGU rejection from unavailable infrastructure:
- `400`/`401`: fail closed and show an error.
- timeout, TLS/connectivity error, `429`, or `5xx`: submit the unchanged credential
to Windows. Windows must still validate it against AD or the cached domain
verifier, so this does not grant access without the last synchronized password.
- `400`/`401`: do not create or update the account; submit the unchanged
credential to Windows so an existing AD account can authenticate.
- timeout, TLS/connectivity error, `429`, or `5xx`: submit the unchanged
credential to Windows. Windows must still validate it against AD or its cached
domain verifier, so this does not grant access without a domain credential.
- usernames that do not match the institutional key format go directly to
Windows and are never sent to SGU or provisioned by the broker.
Redis is deliberately not used for password continuity. A second persistent
password verifier duplicates attackable credential material, while a reversible
+20 -5
View File
@@ -1,10 +1,14 @@
# Fondo de bienvenida personalizado
El enrolamiento instala dos fondos base azules. El escritorio personalizado usa
`assets/branding/darkblue.jpg`, que contiene el logotipo blanco oficial de
Universidad La Salle México, pequeño y elevado en el sector inferior derecho.
La pantalla de bloqueo usa `assets/branding/darkblue-lockscreen.jpg`, que sólo
contiene el fondo azul y nunca muestra el logo. También instala las familias
El enrolamiento instala tres fondos base de escritorio y una base independiente
de pantalla de bloqueo. Alumnos y cuentas sin rol conservan
`assets/branding/darkblue.jpg`; `SGU-Administrativos` usa
`assets/branding/darkgray-administrative.png` y `SGU-Docentes` usa
`assets/branding/darkred-professor.png`. Las tres bases de escritorio contienen
el logotipo blanco oficial de Universidad La Salle México, pequeño y elevado en
el sector inferior derecho. La pantalla de bloqueo usa
`assets/branding/darkblue-lockscreen.jpg`, que sólo contiene el fondo azul y
nunca muestra el logo. También instala las familias
`Indivisa Text Sans` y `Indivisa Text Serif`, y un generador local. El logotipo
está horneado únicamente en la base de escritorio: el generador no carga,
redimensiona ni compone otro logo durante el inicio de sesión. La GPO de equipos
@@ -60,6 +64,13 @@ GPO crea el valor de equipo `SGUWelcomeWallpaper` bajo
el contexto de cada usuario y puede leer sus datos de AD. El resultado se guarda
en `%LOCALAPPDATA%\SGU\Wallpapers` y se aplica con la API nativa de Windows.
La selección de la base se hace a partir de los SID presentes en el token de
inicio de sesión, sin una segunda consulta a AD: exactamente un grupo
`SGU-Administrativos` selecciona gris y exactamente un grupo `SGU-Docentes`
selecciona rojo. Una cuenta sin esos grupos —incluidos los alumnos— conserva el
azul. Si faltase una imagen, el generador vuelve de forma segura a la base azul;
si detecta ambos grupos, también usa azul y registra una advertencia diagnóstica.
La antigua directiva estática de escritorio se elimina para que no sobrescriba
el archivo individual. La personalización sigue estando gobernada por dominio:
el comando de inicio y la pantalla de bloqueo pertenecen a la GPO de equipos.
@@ -80,6 +91,10 @@ dependencia o la API del escritorio no está disponible, el enrolamiento y el
inicio de sesión continúan normalmente y se escribe un diagnóstico en
`~/.local/state/sgu/welcome-wallpaper.log`.
El generador Linux sigue la misma clasificación con `id -nG`: alumnos y cuentas
sin rol usan azul, `SGU-Administrativos` gris y `SGU-Docentes` rojo. No almacena
la pertenencia ni contraseñas locales.
## Tipografía
Los archivos OTF necesarios viajan dentro de cada paquete y se cargan en memoria
+3 -2
View File
@@ -97,8 +97,9 @@ usuario que cerró sesión y deshabilita la enumeración de usuarios locales en
equipo unido al dominio. No modifica ni oculta el proveedor de contraseña de
Microsoft; **Other user** permanece como ruta de recuperación.
Cerrar sesión o reiniciar el equipo. El acceso SGU debe quedar seleccionado por
defecto y el proveedor de contraseña de Microsoft debe permanecer disponible.
Cerrar sesión o reiniciar el equipo. **Acceso Institucional** debe quedar
seleccionado por defecto; el proveedor nativo de Microsoft permanece disponible
para recuperación.
## 5. Verificación
+1
View File
@@ -44,6 +44,7 @@ foreach ($scriptName in @(
'Install-CredentialProvider.ps1',
'Install-SguEnrollmentGuard.ps1',
'Set-SguStandardLocalUser.ps1',
'Set-SguLocalProfileSecurityPolicies.ps1',
'Test-SguClientEnrollment.ps1',
'Repair-SguClientEnrollment.ps1',
'Enable-LabRemoteAccess.ps1',
+6 -1
View File
@@ -370,11 +370,14 @@ install_welcome_wallpaper() {
local source_directory="${SCRIPT_DIRECTORY}/welcome-wallpaper"
local source_script="${source_directory}/Set-SguWelcomeWallpaper.sh"
local source_image="${source_directory}/darkblue.jpg"
local source_administrative_image="${source_directory}/darkgray-administrative.png"
local source_professor_image="${source_directory}/darkred-professor.png"
local install_directory='/usr/local/lib/sgu-welcome-wallpaper'
local configuration_directory='/etc/sgu'
local autostart_directory='/etc/xdg/autostart'
if [[ ! -r $source_script || ! -r $source_image ]]; then
if [[ ! -r $source_script || ! -r $source_image ||
! -r $source_administrative_image || ! -r $source_professor_image ]]; then
printf 'WARNING: Welcome wallpaper assets are absent; domain enrollment will continue without desktop branding.\n' >&2
return 0
fi
@@ -396,6 +399,8 @@ install_welcome_wallpaper() {
install -d -o root -g root -m 755 "$install_directory" "$configuration_directory" "$autostart_directory"
install -o root -g root -m 755 "$source_script" "${install_directory}/Set-SguWelcomeWallpaper.sh"
install -o root -g root -m 644 "$source_image" "${install_directory}/darkblue.jpg"
install -o root -g root -m 644 "$source_administrative_image" "${install_directory}/darkgray-administrative.png"
install -o root -g root -m 644 "$source_professor_image" "${install_directory}/darkred-professor.png"
if compgen -G "${source_directory}/fonts/*.[ot]tf" >/dev/null; then
install -d -o root -g root -m 755 "${install_directory}/fonts"
install -o root -g root -m 644 "${source_directory}"/fonts/*.[ot]tf "${install_directory}/fonts/"
+12 -5
View File
@@ -38,6 +38,8 @@ $interactiveLogonPolicyPath = 'HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\P
$accountPictureSourcePath = Join-Path $PublishPath 'branding\user.png'
$accountPictureDirectory = Join-Path $env:ProgramData 'Microsoft\User Account Pictures'
$welcomeWallpaperSourcePath = Join-Path $PublishPath 'branding\darkblue.jpg'
$welcomeAdministrativeWallpaperSourcePath = Join-Path $PublishPath 'branding\darkgray-administrative.png'
$welcomeProfessorWallpaperSourcePath = Join-Path $PublishPath 'branding\darkred-professor.png'
$welcomeLockScreenSourcePath = Join-Path $PublishPath 'branding\darkblue-lockscreen.jpg'
$welcomeWallpaperScriptSourcePath = Join-Path $PublishPath 'branding\Set-SguWelcomeWallpaper.ps1'
$welcomeFontsSourcePath = Join-Path $PublishPath 'branding\fonts'
@@ -129,6 +131,8 @@ function Install-DefaultAccountPicture {
function Install-WelcomeWallpaperAssets {
if (-not (Test-Path -LiteralPath $welcomeWallpaperSourcePath -PathType Leaf) -or
-not (Test-Path -LiteralPath $welcomeAdministrativeWallpaperSourcePath -PathType Leaf) -or
-not (Test-Path -LiteralPath $welcomeProfessorWallpaperSourcePath -PathType Leaf) -or
-not (Test-Path -LiteralPath $welcomeLockScreenSourcePath -PathType Leaf) -or
-not (Test-Path -LiteralPath $welcomeWallpaperScriptSourcePath -PathType Leaf)) {
return $false
@@ -137,6 +141,10 @@ function Install-WelcomeWallpaperAssets {
New-Item -ItemType Directory -Path $welcomeWallpaperDirectory -Force | Out-Null
Copy-Item -LiteralPath $welcomeWallpaperSourcePath `
-Destination (Join-Path $welcomeWallpaperDirectory 'darkblue.jpg') -Force
Copy-Item -LiteralPath $welcomeAdministrativeWallpaperSourcePath `
-Destination (Join-Path $welcomeWallpaperDirectory 'darkgray-administrative.png') -Force
Copy-Item -LiteralPath $welcomeProfessorWallpaperSourcePath `
-Destination (Join-Path $welcomeWallpaperDirectory 'darkred-professor.png') -Force
Copy-Item -LiteralPath $welcomeLockScreenSourcePath `
-Destination (Join-Path $welcomeWallpaperDirectory 'darkblue-lockscreen.jpg') -Force
Copy-Item -LiteralPath $welcomeWallpaperScriptSourcePath `
@@ -292,10 +300,7 @@ if ($PSCmdlet.ShouldProcess($installPath, 'Install and register the SGU Credenti
New-ItemProperty -Path $classRegistryPath -Name ThreadingModel -Value Both -PropertyType String -Force | Out-Null
New-Item -Path $providerRegistryPath -Force | Out-Null
# Windows PowerShell 5.1 interprets an UTF-8 script without a BOM using the
# current ANSI code page. Construct the middle dot from its Unicode value so
# the LogonUI registry label remains correct on every client locale.
Set-Item -Path $providerRegistryPath -Value ('La Salle {0} Acceso SGU' -f [char]0x00B7)
Set-Item -Path $providerRegistryPath -Value 'Acceso Institucional'
if (-not $DoNotSetAsDefaultCredentialProvider) {
if (-not (Test-Path -LiteralPath $defaultProviderPolicyPath)) {
@@ -308,7 +313,7 @@ if ($PSCmdlet.ShouldProcess($installPath, 'Install and register the SGU Credenti
-Force | Out-Null
}
# Do not leave a signed-out SGU identity exposed as a persistent user tile.
# Do not leave a signed-out domain identity exposed as a persistent user tile.
# The Microsoft password provider remains registered and supplies Other user.
if (-not (Test-Path -LiteralPath $interactiveLogonPolicyPath)) {
New-Item -Path $interactiveLogonPolicyPath -Force | Out-Null
@@ -362,6 +367,8 @@ catch {
SystemPasswordProviderPreserved = $true
WelcomeWallpaperAssetsInstalled =
(Test-Path -LiteralPath (Join-Path $welcomeWallpaperDirectory 'darkblue.jpg') -PathType Leaf) -and
(Test-Path -LiteralPath (Join-Path $welcomeWallpaperDirectory 'darkgray-administrative.png') -PathType Leaf) -and
(Test-Path -LiteralPath (Join-Path $welcomeWallpaperDirectory 'darkred-professor.png') -PathType Leaf) -and
(Test-Path -LiteralPath (Join-Path $welcomeWallpaperDirectory 'darkblue-lockscreen.jpg') -PathType Leaf) -and
(Test-Path -LiteralPath (Join-Path $welcomeWallpaperDirectory 'Set-SguWelcomeWallpaper.ps1') -PathType Leaf)
}
@@ -0,0 +1,191 @@
[CmdletBinding(SupportsShouldProcess)]
param(
[string]$Version = '0.6.16',
[ValidatePattern('^https://')]
[string]$ClientPackageUri = 'https://gitea.lci.ulsa.mx/alexrg/SGU-CredentialProvider/releases/download/v0.6.16/sgu-windows-client-bootstrap-0.6.16.zip',
[ValidatePattern('^[0-9A-Fa-f]{64}$')]
[string]$ClientPackageSha256 = 'AFC40A87E83A6B27319792F575C384EBB175F42DCF670B7AB620A64C75ED499B',
[string]$GpoName = 'SGU - Credential Provider update',
[string]$DomainController = $env:COMPUTERNAME
)
$ErrorActionPreference = 'Stop'
$identity = [Security.Principal.WindowsIdentity]::GetCurrent()
$principal = [Security.Principal.WindowsPrincipal]::new($identity)
if (-not $principal.IsInRole([Security.Principal.WindowsBuiltInRole]::Administrator)) {
throw 'Run this script from an elevated Windows PowerShell session on a domain controller or management host.'
}
Import-Module ActiveDirectory -ErrorAction Stop
Import-Module GroupPolicy -ErrorAction Stop
$domain = Get-ADDomain -Server $DomainController -ErrorAction Stop
$domainDnsRoot = $domain.DNSRoot
$domainDn = $domain.DistinguishedName
$gpo = Get-GPO -Name $GpoName -Domain $domainDnsRoot -Server $DomainController -ErrorAction SilentlyContinue
if (-not $gpo -and $PSCmdlet.ShouldProcess($GpoName, 'Create computer startup update policy')) {
$gpo = New-GPO -Name $GpoName -Domain $domainDnsRoot -Server $DomainController
}
if (-not $gpo) {
throw "The GPO '$GpoName' does not exist and was not created."
}
$existingLink = @(Get-GPInheritance -Target $domainDn -Domain $domainDnsRoot -Server $DomainController).GpoLinks |
Where-Object DisplayName -eq $GpoName |
Select-Object -First 1
if (-not $existingLink -and
$PSCmdlet.ShouldProcess($domainDn, "Link and enable '$GpoName'")) {
New-GPLink -Name $GpoName -Target $domainDn -Domain $domainDnsRoot -Server $DomainController -LinkEnabled Yes | Out-Null
}
elseif ($existingLink -and
$existingLink.Enabled -notin @($true, 'Yes') -and
$PSCmdlet.ShouldProcess($domainDn, "Enable '$GpoName'")) {
Set-GPLink -Name $GpoName -Target $domainDn -Domain $domainDnsRoot -Server $DomainController -LinkEnabled Yes | Out-Null
}
$systemPolicyKey = 'HKLM\Software\Policies\Microsoft\Windows\System'
$winlogonPolicyKey = 'HKLM\Software\Policies\Microsoft\Windows NT\CurrentVersion\Winlogon'
if ($PSCmdlet.ShouldProcess($GpoName, 'Make the computer startup script synchronous')) {
Set-GPRegistryValue -Name $GpoName -Domain $domainDnsRoot -Server $DomainController `
-Key $systemPolicyKey -ValueName 'RunStartupScriptSync' -Type DWord -Value 1
Set-GPRegistryValue -Name $GpoName -Domain $domainDnsRoot -Server $DomainController `
-Key $winlogonPolicyKey -ValueName 'SyncForegroundPolicy' -Type DWord -Value 1
}
$scriptName = "Update-SguCredentialProvider-$Version.ps1"
$gpoScriptsPath = Join-Path $env:WINDIR "SYSVOL\domain\Policies\{$($gpo.Id)}\Machine\Scripts"
$startupPath = Join-Path $gpoScriptsPath 'Startup'
$scriptsIniPath = Join-Path $gpoScriptsPath 'scripts.ini'
$legacyPowerShellScriptsIniPath = Join-Path $gpoScriptsPath 'psscripts.ini'
$scriptPath = Join-Path $startupPath $scriptName
$startupScript = @"
`$ErrorActionPreference = 'Stop'
`$version = '$Version'
`$packageUri = '$ClientPackageUri'
`$expectedSha256 = '$($ClientPackageSha256.ToUpperInvariant())'
`$computerSystem = Get-CimInstance Win32_ComputerSystem
if (-not `$computerSystem.PartOfDomain -or `$computerSystem.DomainRole -ge 4) {
exit 0
}
# Windows remembers the provider used at the last interactive logon. Select
# the institutional tile at startup while leaving the native password tile
# registered for manual recovery.
`$logonUiPath = 'HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\Authentication\LogonUI'
Set-ItemProperty -Path `$logonUiPath -Name LastLoggedOnProvider `
-Value '{D789CFD8-5AD4-489F-9B83-7EB5D9D09335}'
`$updateRoot = Join-Path `$env:ProgramData "SGU\CredentialProviderUpdates\`$version"
`$markerPath = Join-Path `$updateRoot 'complete.marker'
if (Test-Path -LiteralPath `$markerPath -PathType Leaf) {
exit 0
}
New-Item -ItemType Directory -Path `$updateRoot -Force | Out-Null
`$archivePath = Join-Path `$updateRoot 'client-bootstrap.zip'
`$stagePath = Join-Path `$updateRoot 'package'
if ((Test-Path -LiteralPath `$archivePath -PathType Leaf) -and
(Get-FileHash -LiteralPath `$archivePath -Algorithm SHA256).Hash -ne `$expectedSha256) {
Remove-Item -LiteralPath `$archivePath -Force
}
if (-not (Test-Path -LiteralPath `$archivePath -PathType Leaf)) {
Invoke-WebRequest -Uri `$packageUri -OutFile `$archivePath -UseBasicParsing -TimeoutSec 600
}
if ((Get-FileHash -LiteralPath `$archivePath -Algorithm SHA256).Hash -ne `$expectedSha256) {
throw 'The SGU Credential Provider update package did not match its expected SHA-256.'
}
`$installScript = Join-Path `$stagePath 'payload\scripts\Install-CredentialProvider.ps1'
if (-not (Test-Path -LiteralPath `$installScript -PathType Leaf)) {
if (Test-Path -LiteralPath `$stagePath -PathType Container) {
Remove-Item -LiteralPath `$stagePath -Recurse -Force
}
New-Item -ItemType Directory -Path `$stagePath -Force | Out-Null
Add-Type -AssemblyName System.IO.Compression.FileSystem
[IO.Compression.ZipFile]::ExtractToDirectory(`$archivePath, `$stagePath)
}
if (-not (Test-Path -LiteralPath `$installScript -PathType Leaf)) {
throw 'The verified update package did not contain Install-CredentialProvider.ps1.'
}
`$settingsPath = Join-Path `$env:ProgramData 'SGU\CredentialProvider\settings.json'
`$settings = Get-Content -LiteralPath `$settingsPath -Raw | ConvertFrom-Json
`$installParameters = @{
PublishPath = (Join-Path `$stagePath 'payload\credential-provider')
BrokerEndpoint = [string]`$settings.BrokerEndpoint
ClientCertificateThumbprint = [string]`$settings.ClientCertificateThumbprint
ServerCertificateThumbprint = [string]`$settings.ServerCertificateThumbprint
DomainNetbios = [string]`$settings.DomainNetbios
TimeoutSeconds = [int]`$settings.TimeoutSeconds
}
`$dotnet = Join-Path `$env:ProgramFiles 'dotnet\dotnet.exe'
`$runtimeInstalled = (Test-Path -LiteralPath `$dotnet -PathType Leaf) -and
(& `$dotnet --list-runtimes | Select-String '^Microsoft\.NETCore\.App 10\.')
if (-not `$runtimeInstalled) {
`$runtimeInstaller = Get-ChildItem -LiteralPath (Join-Path `$stagePath 'payload\prerequisites') -Filter '*x64*.exe' -File |
Select-Object -First 1
if (-not `$runtimeInstaller) {
throw 'The update package does not contain the required .NET x64 runtime installer.'
}
`$installParameters.InstallDotNetRuntime = `$true
`$installParameters.DotNetRuntimeInstallerPath = `$runtimeInstaller.FullName
}
& `$installScript @installParameters | Out-Null
[IO.File]::WriteAllText(`$markerPath, (Get-Date).ToUniversalTime().ToString('o'), [Text.UTF8Encoding]::new(`$false))
"@
if ($PSCmdlet.ShouldProcess($startupPath, "Install '$scriptName' as a computer startup script")) {
New-Item -ItemType Directory -Path $startupPath -Force | Out-Null
[IO.File]::WriteAllText($scriptPath, $startupScript, [Text.UTF8Encoding]::new($false))
$scriptUncPath = "\\$domainDnsRoot\SYSVOL\$domainDnsRoot\Policies\{$($gpo.Id)}\Machine\Scripts\Startup\$scriptName"
$scriptsIni = "[Startup]`r`n0CmdLine=powershell.exe`r`n0Parameters=-NoProfile -NonInteractive -ExecutionPolicy Bypass -File `"$scriptUncPath`"`r`n"
# The Scripts CSE requires UTF-16LE with a BOM. The explicit process
# execution policy allows the verified installer to run on Windows clients
# whose default PowerShell policy is Restricted.
[IO.File]::WriteAllText($scriptsIniPath, $scriptsIni, [Text.Encoding]::Unicode)
if (Test-Path -LiteralPath $legacyPowerShellScriptsIniPath -PathType Leaf) {
Remove-Item -LiteralPath $legacyPowerShellScriptsIniPath -Force
}
# Writing SYSVOL directly does not register the Scripts CSE in the GPO's
# Active Directory object. Without it, gpresult lists the GPO but the
# client never executes its startup script.
$gpoDn = "CN={$($gpo.Id)},CN=Policies,CN=System,$domainDn"
$gpoObject = Get-ADObject -Identity $gpoDn -Server $DomainController `
-Properties gPCMachineExtensionNames,versionNumber
$scriptExtension = '[{42B5FAAE-6536-11D2-AE5A-0000F87571E3}{40B6664F-4972-11D1-A7CA-0000F87571E3}]'
$extensionNames = [string]$gpoObject.gPCMachineExtensionNames
if ($extensionNames.IndexOf($scriptExtension, [StringComparison]::OrdinalIgnoreCase) -lt 0) {
Set-ADObject -Identity $gpoDn -Server $DomainController `
-Replace @{gPCMachineExtensionNames = "$extensionNames$scriptExtension"}
}
# Keep the AD and SYSVOL computer versions synchronized and force clients
# to process this corrected script registration on their next refresh.
$gptIniPath = Join-Path (Split-Path (Split-Path $gpoScriptsPath -Parent) -Parent) 'GPT.ini'
$gptIni = Get-Content -LiteralPath $gptIniPath -Raw
$gptVersion = [int]([regex]::Match($gptIni, '(?m)^Version=(\d+)\r?$').Groups[1].Value)
$adVersion = [int]$gpoObject.versionNumber
$baseVersion = [Math]::Max($gptVersion, $adVersion)
$nextVersion = ($baseVersion -band -65536) -bor (($baseVersion + 1) -band 65535)
$updatedGptIni = [regex]::Replace($gptIni, '(?m)^Version=\d+\r?$', "Version=$nextVersion")
[IO.File]::WriteAllText($gptIniPath, $updatedGptIni, [Text.Encoding]::ASCII)
Set-ADObject -Identity $gpoDn -Server $DomainController -Replace @{versionNumber = $nextVersion}
}
[pscustomobject]@{
GpoName = $gpo.DisplayName
GpoId = $gpo.Id
LinkedTarget = $domainDn
StartupScript = $scriptPath
Version = $Version
PackageSha256 = $ClientPackageSha256.ToUpperInvariant()
}
+14
View File
@@ -129,6 +129,7 @@ $clientScripts = @(
'Register-SguClientCertificate.ps1',
'Repair-SguClientEnrollment.ps1',
'Set-SguStandardLocalUser.ps1',
'Set-SguLocalProfileSecurityPolicies.ps1',
'Test-SguClientEnrollment.ps1'
)
foreach ($scriptName in $clientScripts) {
@@ -143,6 +144,10 @@ Copy-RequiredFile -Source (Join-Path $repositoryRoot 'assets\branding\lasalle-ma
-Destination (Join-Path $clientRoot 'payload\credential-provider\branding\user.png')
Copy-RequiredFile -Source (Join-Path $repositoryRoot 'assets\branding\darkblue.jpg') `
-Destination (Join-Path $clientRoot 'payload\credential-provider\branding\darkblue.jpg')
Copy-RequiredFile -Source (Join-Path $repositoryRoot 'assets\branding\darkgray-administrative.png') `
-Destination (Join-Path $clientRoot 'payload\credential-provider\branding\darkgray-administrative.png')
Copy-RequiredFile -Source (Join-Path $repositoryRoot 'assets\branding\darkred-professor.png') `
-Destination (Join-Path $clientRoot 'payload\credential-provider\branding\darkred-professor.png')
Copy-RequiredFile -Source (Join-Path $repositoryRoot 'assets\branding\darkblue-lockscreen.jpg') `
-Destination (Join-Path $clientRoot 'payload\credential-provider\branding\darkblue-lockscreen.jpg')
Copy-RequiredFile -Source (Join-Path $PSScriptRoot 'Set-SguWelcomeWallpaper.ps1') `
@@ -182,6 +187,10 @@ Copy-RequiredFile -Source (Join-Path $PSScriptRoot 'Set-SguWelcomeWallpaper.sh')
-Destination (Join-Path $linuxClientRoot 'welcome-wallpaper\Set-SguWelcomeWallpaper.sh')
Copy-RequiredFile -Source (Join-Path $repositoryRoot 'assets\branding\darkblue.jpg') `
-Destination (Join-Path $linuxClientRoot 'welcome-wallpaper\darkblue.jpg')
Copy-RequiredFile -Source (Join-Path $repositoryRoot 'assets\branding\darkgray-administrative.png') `
-Destination (Join-Path $linuxClientRoot 'welcome-wallpaper\darkgray-administrative.png')
Copy-RequiredFile -Source (Join-Path $repositoryRoot 'assets\branding\darkred-professor.png') `
-Destination (Join-Path $linuxClientRoot 'welcome-wallpaper\darkred-professor.png')
foreach ($fontName in $welcomeFontNames) {
Copy-RequiredFile -Source (Join-Path $repositoryRoot "assets\branding\fonts\$fontName") `
-Destination (Join-Path $linuxClientRoot "welcome-wallpaper\fonts\$fontName")
@@ -217,6 +226,7 @@ $serverScripts = @(
'Set-LabBrokerDns.ps1',
'Set-SguDomainComputerPolicies.ps1',
'Set-SguLaboratorioWallpaperPolicy.ps1',
'Set-SguLocalProfileSecurityPolicies.ps1',
'Set-SguDomainUserPolicies.ps1'
)
foreach ($scriptName in $serverScripts) {
@@ -240,6 +250,10 @@ Copy-RequiredFile -Source (Join-Path $PSScriptRoot 'Set-SguWelcomeWallpaper.ps1'
-Destination (Join-Path $serverContentTarget 'welcome-wallpaper\Set-SguWelcomeWallpaper.ps1')
Copy-RequiredFile -Source (Join-Path $repositoryRoot 'assets\branding\darkblue.jpg') `
-Destination (Join-Path $serverContentTarget 'welcome-wallpaper\darkblue.jpg')
Copy-RequiredFile -Source (Join-Path $repositoryRoot 'assets\branding\darkgray-administrative.png') `
-Destination (Join-Path $serverContentTarget 'welcome-wallpaper\darkgray-administrative.png')
Copy-RequiredFile -Source (Join-Path $repositoryRoot 'assets\branding\darkred-professor.png') `
-Destination (Join-Path $serverContentTarget 'welcome-wallpaper\darkred-professor.png')
Copy-RequiredFile -Source (Join-Path $repositoryRoot 'assets\branding\darkblue-lockscreen.jpg') `
-Destination (Join-Path $serverContentTarget 'welcome-wallpaper\darkblue-lockscreen.jpg')
foreach ($fontName in $welcomeFontNames) {
+23 -3
View File
@@ -6,6 +6,8 @@ param(
[string]$EventCollectorFqdn,
[string]$WelcomeWallpaperScriptPath = 'C:\ProgramData\SGU\Branding\Set-SguWelcomeWallpaper.ps1',
[string]$WelcomeWallpaperBasePath = 'C:\ProgramData\SGU\Branding\darkblue.jpg',
[string]$WelcomeAdministrativeWallpaperBasePath = 'C:\ProgramData\SGU\Branding\darkgray-administrative.png',
[string]$WelcomeProfessorWallpaperBasePath = 'C:\ProgramData\SGU\Branding\darkred-professor.png',
[string]$WelcomeLockScreenBasePath = 'C:\ProgramData\SGU\Branding\darkblue-lockscreen.jpg'
)
@@ -82,9 +84,12 @@ $runPolicyKey = 'HKLM\Software\Microsoft\Windows\CurrentVersion\Run'
$personalizationPolicyKey = 'HKLM\Software\Policies\Microsoft\Windows\Personalization'
$personalizationCspKey = 'HKLM\Software\Microsoft\Windows\CurrentVersion\PersonalizationCSP'
$cloudContentPolicyKey = 'HKLM\Software\Policies\Microsoft\Windows\CloudContent'
$edgePolicyKey = 'HKLM\Software\Policies\Microsoft\Edge'
$workstationUserPolicyKey = 'HKCU\Software\Microsoft\Windows\CurrentVersion\Policies\System'
$desktopUserPolicyKey = 'HKCU\Software\Policies\Microsoft\Windows\Control Panel\Desktop'
$providerClassId = '{D789CFD8-5AD4-489F-9B83-7EB5D9D09335}'
$welcomeWallpaperCommand = 'powershell.exe -NoLogo -NoProfile -NonInteractive -WindowStyle Hidden -ExecutionPolicy Bypass -File "{0}" -BaseImagePath "{1}"' -f `
$WelcomeWallpaperScriptPath,$WelcomeWallpaperBasePath
$welcomeWallpaperCommand = 'powershell.exe -NoLogo -NoProfile -NonInteractive -WindowStyle Hidden -ExecutionPolicy Bypass -File "{0}" -BaseImagePath "{1}" -AdministrativeBaseImagePath "{2}" -ProfessorBaseImagePath "{3}"' -f `
$WelcomeWallpaperScriptPath,$WelcomeWallpaperBasePath,$WelcomeAdministrativeWallpaperBasePath,$WelcomeProfessorWallpaperBasePath
$policies = @(
@{ Key = $dataCollectionKey; Name = 'AllowTelemetry'; Type = 'DWord'; Value = 0 },
@{ Key = $dataCollectionKey; Name = 'DisableTelemetryOptInSettingsUx'; Type = 'DWord'; Value = 1 },
@@ -124,7 +129,20 @@ $policies = @(
@{ Key = $personalizationCspKey; Name = 'LockScreenImageUrl'; Type = 'String'; Value = $WelcomeLockScreenBasePath },
@{ Key = $personalizationCspKey; Name = 'LockScreenImageStatus'; Type = 'DWord'; Value = 1 },
@{ Key = $cloudContentPolicyKey; Name = 'DisableWindowsSpotlightFeatures'; Type = 'DWord'; Value = 1 },
@{ Key = $cloudContentPolicyKey; Name = 'DisableWindowsSpotlightOnLockScreen'; Type = 'DWord'; Value = 1 }
@{ Key = $cloudContentPolicyKey; Name = 'DisableWindowsSpotlightOnLockScreen'; Type = 'DWord'; Value = 1 },
# Shared laboratory machines should open Edge without consumer onboarding,
# personal browser profiles, or Microsoft cloud synchronization.
@{ Key = $edgePolicyKey; Name = 'HideFirstRunExperience'; Type = 'DWord'; Value = 1 },
@{ Key = $edgePolicyKey; Name = 'BrowserSignin'; Type = 'DWord'; Value = 0 },
@{ Key = $edgePolicyKey; Name = 'SyncDisabled'; Type = 'DWord'; Value = 1 },
# User policy is evaluated through the computer-scoped loopback policy in
# Set-SguLaboratorioWallpaperPolicy.ps1. Keep this authoritative copy in
# the primary client GPO as well so every managed lab workstation has the
# same intent during recovery or when the wallpaper GPO is rebuilt.
@{ Key = $workstationUserPolicyKey; Name = 'DisableLockWorkstation'; Type = 'DWord'; Value = 1 },
@{ Key = $desktopUserPolicyKey; Name = 'ScreenSaveActive'; Type = 'String'; Value = '0' }
)
$powerSettingIds = @(
@@ -177,6 +195,8 @@ $linkEnabled = $link -and (
PolicyCount = $configuredPolicies.Count
EventCollector = $EventCollectorFqdn
WelcomeWallpaperCommand = $welcomeWallpaperCommand
WelcomeAdministrativeWallpaper = $WelcomeAdministrativeWallpaperBasePath
WelcomeProfessorWallpaper = $WelcomeProfessorWallpaperBasePath
LockScreenImage = $WelcomeLockScreenBasePath
Policies = [pscustomobject]$configuredPolicies
}
+125 -4
View File
@@ -4,7 +4,8 @@ param(
[string]$TargetOuDn = 'OU=Laboratorio,DC=lci,DC=lasalle,DC=mx',
[string]$GpoName = 'SGU - Laboratorio wallpaper protection',
[string]$DomainController = $env:COMPUTERNAME,
[string]$WallpaperPath = '%LOCALAPPDATA%\SGU\Wallpapers\welcome-%COMPUTERNAME%.jpg'
[string]$WallpaperPath = '%LOCALAPPDATA%\SGU\Wallpapers\welcome-%COMPUTERNAME%.jpg',
[string]$LocalProfilePolicyScriptPath = (Join-Path $PSScriptRoot 'Set-SguLocalProfileSecurityPolicies.ps1')
)
$ErrorActionPreference = 'Stop'
@@ -12,6 +13,118 @@ Import-Module ActiveDirectory -ErrorAction Stop
Import-Module GroupPolicy -ErrorAction Stop
$domainName = (Get-ADDomain -Server $DomainController).DNSRoot
Get-ADOrganizationalUnit -Identity $TargetOuDn -Server $DomainController -ErrorAction Stop | Out-Null
function Set-SguLocalProfilePolicyStartupScript {
param(
[Parameter(Mandatory)]$Gpo,
[Parameter(Mandatory)][string]$DomainName,
[Parameter(Mandatory)][string]$DomainController,
[Parameter(Mandatory)][string]$SourceScript
)
if (-not (Test-Path -LiteralPath $SourceScript -PathType Leaf)) {
throw 'Set-SguLocalProfileSecurityPolicies.ps1 must be beside Set-SguLaboratorioWallpaperPolicy.ps1.'
}
$domainDn = (Get-ADDomain -Server $DomainController).DistinguishedName
$gpoAdPath = "CN={$($Gpo.Id)},CN=Policies,CN=System,$domainDn"
$gpoAd = Get-ADObject -Identity $gpoAdPath -Properties gPCFileSysPath,gPCMachineExtensionNames,versionNumber `
-Server $DomainController -ErrorAction Stop
$scriptsRoot = Join-Path $gpoAd.gPCFileSysPath 'Machine\Scripts'
$startupRoot = Join-Path $scriptsRoot 'Startup'
$destinationScript = Join-Path $startupRoot 'Set-SguLocalProfileSecurityPolicies.ps1'
$startupLauncher = Join-Path $startupRoot 'Start-SguLocalProfileSecurityPolicies.cmd'
$scriptsIniPath = Join-Path $scriptsRoot 'scripts.ini'
$legacyPowerShellScriptsIniPath = Join-Path $scriptsRoot 'psscripts.ini'
$scriptsIni = @"
[Startup]
0CmdLine=Start-SguLocalProfileSecurityPolicies.cmd
0Parameters=
"@
$normalizedScriptsIni = $scriptsIni.TrimEnd("`r", "`n")
$launcherContents = @"
@echo off
"%SystemRoot%\System32\WindowsPowerShell\v1.0\powershell.exe" -NoLogo -NoProfile -NonInteractive -ExecutionPolicy Bypass -File "%~dp0Set-SguLocalProfileSecurityPolicies.ps1" -RunAsSystem
exit /b %ERRORLEVEL%
"@
$normalizedLauncherContents = $launcherContents.TrimEnd("`r", "`n")
$legacyManagedPowerShellScriptsIni = @"
[Startup]
0CmdLine=Set-SguLocalProfileSecurityPolicies.ps1
0Parameters=-RunAsSystem
"@.TrimEnd("`r", "`n")
# These are the Script CSE and its Group Policy editor snap-in. Domain
# clients ignore scripts.ini unless this CSE pair is on the GPO object.
$startupScriptExtension = '[{42B5FAAE-6536-11D2-AE5A-0000F87571E3}{40B66650-4972-11D1-A7CA-0000F87571E3}]'
# gPCMachineExtensionNames is a single concatenated AD attribute, even
# though it holds several CSE/snap-in GUID pairs.
$extensionValue = [string]($gpoAd.gPCMachineExtensionNames -join '')
$needsExtension = $extensionValue -notmatch [regex]::Escape($startupScriptExtension)
$needsScript = -not (Test-Path -LiteralPath $destinationScript -PathType Leaf)
if (-not $needsScript) {
$needsScript = (Get-FileHash -LiteralPath $SourceScript -Algorithm SHA256).Hash -ne
(Get-FileHash -LiteralPath $destinationScript -Algorithm SHA256).Hash
}
$needsIni = -not (Test-Path -LiteralPath $scriptsIniPath -PathType Leaf) -or
(Get-Content -LiteralPath $scriptsIniPath -Raw).TrimEnd("`r", "`n") -ne $normalizedScriptsIni
$needsLauncher = -not (Test-Path -LiteralPath $startupLauncher -PathType Leaf) -or
(Get-Content -LiteralPath $startupLauncher -Raw).TrimEnd("`r", "`n") -ne $normalizedLauncherContents
$removeLegacyPowerShellScriptsIni = (Test-Path -LiteralPath $legacyPowerShellScriptsIniPath -PathType Leaf) -and
(Get-Content -LiteralPath $legacyPowerShellScriptsIniPath -Raw).TrimEnd("`r", "`n") -eq $legacyManagedPowerShellScriptsIni
if ($needsScript -or $needsIni -or $needsLauncher -or $needsExtension -or $removeLegacyPowerShellScriptsIni) {
New-Item -ItemType Directory -Path $startupRoot -Force | Out-Null
Copy-Item -LiteralPath $SourceScript -Destination $destinationScript -Force
Set-Content -LiteralPath $scriptsIniPath -Value $normalizedScriptsIni -Encoding ASCII -NoNewline
Set-Content -LiteralPath $startupLauncher -Value $normalizedLauncherContents -Encoding ASCII -NoNewline
if ($removeLegacyPowerShellScriptsIni) {
Remove-Item -LiteralPath $legacyPowerShellScriptsIniPath -Force
}
if ($needsExtension) {
$extensionValue += $startupScriptExtension
}
# A GPO is replicated as both its SYSVOL file tree and its AD object.
# Bump the computer-side version only after the files are ready, then
# publish the same version in AD so clients process this new startup
# script on their next boot.
$currentVersion = [int64]$gpoAd.versionNumber
$currentComputerVersion = $currentVersion -band 0xFFFF
if ($currentComputerVersion -ge 65535) {
throw 'The laboratory GPO computer version cannot be incremented further.'
}
$nextVersion = ($currentVersion -band 0xFFFF0000) -bor ($currentComputerVersion + 1)
$gptIniPath = Join-Path $gpoAd.gPCFileSysPath 'gpt.ini'
$gptIni = Get-Content -LiteralPath $gptIniPath -Raw
$gptIni = [regex]::Replace($gptIni, '(?m)^Version=\d+\s*$', "Version=$nextVersion")
Set-Content -LiteralPath $gptIniPath -Value $gptIni -Encoding ASCII
# Set-ADObject validates a -Replace hashtable as one value type, so
# update the extension string and integer version in separate writes.
Set-ADObject -Identity $gpoAd.DistinguishedName -Server $DomainController -Replace @{
gPCMachineExtensionNames = $extensionValue
}
Set-ADObject -Identity $gpoAd.DistinguishedName -Server $DomainController -Replace @{
versionNumber = $nextVersion
}
}
$verifiedGpoAd = Get-ADObject -Identity $gpoAdPath -Properties gPCMachineExtensionNames `
-Server $DomainController -ErrorAction Stop
if ([string]($verifiedGpoAd.gPCMachineExtensionNames -join '') -notmatch [regex]::Escape($startupScriptExtension) -or
-not (Test-Path -LiteralPath $destinationScript -PathType Leaf) -or
-not (Test-Path -LiteralPath $startupLauncher -PathType Leaf) -or
(Get-Content -LiteralPath $scriptsIniPath -Raw).TrimEnd("`r", "`n") -ne $normalizedScriptsIni -or
(Get-Content -LiteralPath $startupLauncher -Raw).TrimEnd("`r", "`n") -ne $normalizedLauncherContents) {
throw 'The laboratory local-profile startup policy was not configured correctly.'
}
return [pscustomobject]@{
Configured = $true
Script = $destinationScript
RunsAs = 'LocalSystem'
}
}
if (-not $PSCmdlet.ShouldProcess($TargetOuDn, "Apply '$GpoName' with enforced loopback Merge")) {
return
}
@@ -25,14 +138,17 @@ if ($gpo) {
}
else {
$gpo = New-GPO -Name $GpoName -Domain $domainName -Server $DomainController `
-Comment 'Protects the SGU desktop wallpaper on Laboratorio computers and child OUs; loopback Merge preserves existing user policies.'
-Comment 'Protects the SGU desktop wallpaper and prevents workstation locking for every user on Laboratorio computers and child OUs; loopback Merge preserves existing user policies.'
}
# These are user policies scoped by the computer OU, not by the user OU.
# These are user policies scoped by the computer OU, not by the user OU. The
# enforced loopback GPO therefore applies to local accounts such as .\ing as
# well as domain accounts that log on to a managed laboratory machine.
# Match the per-user/per-computer output of Set-SguWelcomeWallpaper.ps1.
$settings = @(
@{ Key = 'HKLM\Software\Policies\Microsoft\Windows\System'; Name = 'UserPolicyMode'; Type = 'DWord'; Value = 1 },
@{ Key = 'HKCU\Software\Microsoft\Windows\CurrentVersion\Policies\ActiveDesktop'; Name = 'NoChangingWallPaper'; Type = 'DWord'; Value = 1 },
@{ Key = 'HKCU\Software\Microsoft\Windows\CurrentVersion\Policies\System'; Name = 'DisableLockWorkstation'; Type = 'DWord'; Value = 1 },
@{ Key = 'HKCU\Software\Policies\Microsoft\Windows\Control Panel\Desktop'; Name = 'ScreenSaveActive'; Type = 'String'; Value = '0' },
@{ Key = 'HKCU\Software\Microsoft\Windows\CurrentVersion\Policies\System'; Name = 'Wallpaper'; Type = 'ExpandString'; Value = $WallpaperPath },
@{ Key = 'HKCU\Software\Microsoft\Windows\CurrentVersion\Policies\System'; Name = 'WallpaperStyle'; Type = 'String'; Value = '10' }
)
@@ -64,12 +180,17 @@ foreach ($setting in $settings) {
throw "Wallpaper policy verification failed for $($setting.Name)."
}
}
$startupPolicy = Set-SguLocalProfilePolicyStartupScript -Gpo $gpo -DomainName $domainName `
-DomainController $DomainController -SourceScript $LocalProfilePolicyScriptPath
[pscustomobject]@{
Name = $gpo.DisplayName
Id = $gpo.Id
TargetOuDn = $TargetOuDn
WallpaperPath = $WallpaperPath
Loopback = 'Merge'
DisableLockWorkstationForAllUsers = $true
LocalProfileStartupPolicy = $startupPolicy.Configured
LocalProfileStartupScript = $startupPolicy.Script
Enforced = $true
BackupPath = $backupPath
}
@@ -0,0 +1,249 @@
#Requires -Version 5.1
[CmdletBinding(SupportsShouldProcess)]
param(
[switch]$RunAsSystem,
[string]$StatePath = "$env:ProgramData\SGU\Enrollment\local-profile-security-policy.json"
)
$ErrorActionPreference = 'Stop'
$policyRelativePath = 'Software\Microsoft\Windows\CurrentVersion\Policies\System'
$policyValueName = 'DisableLockWorkstation'
$systemSid = 'S-1-5-18'
function Test-SguRunningAsSystem {
$currentSid = [Security.Principal.WindowsIdentity]::GetCurrent().User.Value
return $currentSid -eq $systemSid
}
function Set-SguRegistryDword {
param(
[Parameter(Mandatory)][string]$RegistryPath,
[Parameter(Mandatory)][string]$Name,
[Parameter(Mandatory)][int]$Value
)
New-Item -Path $RegistryPath -Force | Out-Null
New-ItemProperty -Path $RegistryPath -Name $Name -PropertyType DWord -Value $Value -Force | Out-Null
$actual = Get-ItemPropertyValue -Path $RegistryPath -Name $Name -ErrorAction Stop
if ([int]$actual -ne $Value) {
throw "Could not set $Name to $Value in $RegistryPath."
}
}
function Set-SguRegHiveDword {
param(
[Parameter(Mandatory)][string]$Hive,
[Parameter(Mandatory)][string]$Name,
[Parameter(Mandatory)][int]$Value
)
# Do not use the PowerShell registry provider against an offline NTUSER.DAT
# hive. It can retain a registry-key handle until the runspace exits, which
# prevents reg.exe from unloading that hive. reg.exe opens and closes its
# own handle before returning.
$key = "$Hive\$policyRelativePath"
& reg.exe add $key /v $Name /t REG_DWORD /d $Value /f | Out-Null
if ($LASTEXITCODE -ne 0) {
throw "Could not set $Name in offline hive $Hive (exit code $LASTEXITCODE)."
}
$verification = (& reg.exe query $key /v $Name) -join [Environment]::NewLine
if ($LASTEXITCODE -ne 0 -or ($verification -notmatch "\b$Name\b\s+REG_DWORD\s+0x0*1\b")) {
throw "Could not verify $Name in offline hive $Hive."
}
}
function Invoke-SguProfileHivePolicy {
param(
[Parameter(Mandatory)]$Profile,
[Parameter(Mandatory)][string]$HiveName
)
$profilePath = [string]$Profile.LocalPath
$ntUserDat = Join-Path $profilePath 'NTUSER.DAT'
if (-not (Test-Path -LiteralPath $ntUserDat -PathType Leaf)) {
return [pscustomobject]@{
UserName = Split-Path $profilePath -Leaf
Sid = [string]$Profile.SID
LocalPath = $profilePath
Status = 'SkippedNoHive'
DisableLockWorkstation = $false
}
}
$userName = Split-Path $profilePath -Leaf
$loadedHivePath = "Registry::HKEY_USERS\$($Profile.SID)"
if ($Profile.Loaded -and (Test-Path -LiteralPath $loadedHivePath)) {
Set-SguRegistryDword -RegistryPath (Join-Path $loadedHivePath $policyRelativePath) `
-Name $policyValueName -Value 1
return [pscustomobject]@{
UserName = $userName
Sid = [string]$Profile.SID
LocalPath = $profilePath
Status = 'UpdatedLoadedHive'
DisableLockWorkstation = $true
}
}
$regHive = "HKU\$HiveName"
& reg.exe load $regHive $ntUserDat | Out-Null
if ($LASTEXITCODE -ne 0) {
throw "Unable to load the local profile hive for '$userName' (exit code $LASTEXITCODE)."
}
try {
Set-SguRegHiveDword -Hive $regHive -Name $policyValueName -Value 1
}
finally {
& reg.exe unload $regHive | Out-Null
if ($LASTEXITCODE -ne 0) {
throw "Unable to unload the local profile hive for '$userName' (exit code $LASTEXITCODE)."
}
}
[pscustomobject]@{
UserName = $userName
Sid = [string]$Profile.SID
LocalPath = $profilePath
Status = 'UpdatedUnloadedHive'
DisableLockWorkstation = $true
}
}
function Invoke-SguDefaultProfilePolicy {
$defaultProfile = Join-Path $env:SystemDrive 'Users\Default\NTUSER.DAT'
if (-not (Test-Path -LiteralPath $defaultProfile -PathType Leaf)) {
throw "The default user hive was not found at $defaultProfile."
}
$hiveName = 'SGU-DefaultProfile-' + [guid]::NewGuid().ToString('N')
$regHive = "HKU\$hiveName"
& reg.exe load $regHive $defaultProfile | Out-Null
if ($LASTEXITCODE -ne 0) {
throw "Unable to load the default user hive (exit code $LASTEXITCODE)."
}
try {
Set-SguRegHiveDword -Hive $regHive -Name $policyValueName -Value 1
}
finally {
& reg.exe unload $regHive | Out-Null
if ($LASTEXITCODE -ne 0) {
throw "Unable to unload the default user hive (exit code $LASTEXITCODE)."
}
}
}
function Invoke-SguSystemWorker {
param(
[Parameter(Mandatory)][string]$ScriptPath,
[Parameter(Mandatory)][string]$ResultPath
)
$taskName = 'SGU-ApplyLocalProfileSecurity-' + [guid]::NewGuid().ToString('N')
$powerShellPath = Join-Path $env:SystemRoot 'System32\WindowsPowerShell\v1.0\powershell.exe'
$escapedScriptPath = $ScriptPath.Replace("'", "''")
$escapedResultPath = $ResultPath.Replace("'", "''")
# Task Scheduler does not apply PowerShell quoting rules to a -File command
# line consistently. An encoded command makes the SYSTEM hand-off reliable
# even when the enrollment directory contains spaces.
$workerCommand = "& '$escapedScriptPath' -RunAsSystem -StatePath '$escapedResultPath'"
$encodedWorkerCommand = [Convert]::ToBase64String([Text.Encoding]::Unicode.GetBytes($workerCommand))
$arguments = "-NoLogo -NoProfile -NonInteractive -ExecutionPolicy Bypass -EncodedCommand $encodedWorkerCommand"
$action = New-ScheduledTaskAction -Execute $powerShellPath -Argument $arguments
$principal = New-ScheduledTaskPrincipal -UserId 'SYSTEM' -LogonType ServiceAccount -RunLevel Highest
try {
Register-ScheduledTask -TaskName $taskName -Action $action -Principal $principal -Force | Out-Null
Start-ScheduledTask -TaskName $taskName
$deadline = (Get-Date).AddMinutes(2)
do {
Start-Sleep -Milliseconds 400
$task = Get-ScheduledTask -TaskName $taskName -ErrorAction Stop
} while ($task.State -eq 'Running' -and (Get-Date) -lt $deadline)
$taskInfo = Get-ScheduledTaskInfo -TaskName $taskName -ErrorAction Stop
if ($task.State -eq 'Running') {
throw 'The temporary SYSTEM policy worker did not finish within two minutes.'
}
if (-not (Test-Path -LiteralPath $ResultPath -PathType Leaf)) {
if ($taskInfo.LastTaskResult -ne 0) {
throw "The temporary SYSTEM policy worker failed with exit code $($taskInfo.LastTaskResult) and did not write its verification state."
}
throw 'The SYSTEM policy worker completed without writing its verification state.'
}
$result = Get-Content -LiteralPath $ResultPath -Raw | ConvertFrom-Json
if ($taskInfo.LastTaskResult -ne 0) {
$failureDetail = if ($result.Error) { ": $($result.Error)" } else { '' }
throw "The temporary SYSTEM policy worker failed with exit code $($taskInfo.LastTaskResult)$failureDetail"
}
if (-not $result.IsValid) {
throw 'The SYSTEM policy worker did not verify every local user profile.'
}
return $result
}
finally {
Unregister-ScheduledTask -TaskName $taskName -Confirm:$false -ErrorAction SilentlyContinue
}
}
$identity = [Security.Principal.WindowsIdentity]::GetCurrent()
$principal = [Security.Principal.WindowsPrincipal]::new($identity)
if (-not $principal.IsInRole([Security.Principal.WindowsBuiltInRole]::Administrator)) {
throw 'Run this script from an elevated Windows PowerShell session.'
}
if ($RunAsSystem -and -not (Test-SguRunningAsSystem)) {
throw '-RunAsSystem is reserved for the temporary SYSTEM policy worker.'
}
$stateDirectory = Split-Path -Path $StatePath -Parent
if (-not $RunAsSystem) {
if (-not $PSCmdlet.ShouldProcess($env:COMPUTERNAME, 'Apply DisableLockWorkstation to every local user profile')) {
return
}
New-Item -ItemType Directory -Path $stateDirectory -Force | Out-Null
$workerResult = Invoke-SguSystemWorker -ScriptPath $PSCommandPath -ResultPath $StatePath
return [pscustomobject]$workerResult
}
New-Item -ItemType Directory -Path $stateDirectory -Force | Out-Null
$profileResults = [Collections.Generic.List[object]]::new()
$defaultProfileConfigured = $false
$failure = $null
try {
$localSids = @(Get-LocalUser | ForEach-Object { $_.SID.Value })
$localProfiles = @(Get-CimInstance Win32_UserProfile | Where-Object {
-not $_.Special -and $localSids -contains $_.SID
})
$counter = 0
foreach ($profile in $localProfiles) {
$counter++
$hiveName = 'SGU-LocalProfile-{0}-{1}' -f $counter, [guid]::NewGuid().ToString('N')
$profileResults.Add((Invoke-SguProfileHivePolicy -Profile $profile -HiveName $hiveName))
}
Invoke-SguDefaultProfilePolicy
$defaultProfileConfigured = $true
}
catch {
$failure = $_.Exception.Message
}
$failedProfiles = @($profileResults | Where-Object { -not $_.DisableLockWorkstation })
$result = [pscustomobject]@{
ComputerName = $env:COMPUTERNAME
GeneratedAt = (Get-Date).ToString('o')
IsValid = ([string]::IsNullOrWhiteSpace($failure) -and $defaultProfileConfigured -and $failedProfiles.Count -eq 0)
PolicyName = $policyValueName
PolicyValue = 1
LocalProfiles = @($profileResults)
DefaultProfileConfigured = $defaultProfileConfigured
Error = $failure
}
$result | ConvertTo-Json -Depth 5 | Set-Content -LiteralPath $StatePath -Encoding UTF8
if (-not $result.IsValid) {
$failureMessage = if ($failure) {
$failure
}
else {
'DisableLockWorkstation could not be applied to every local user profile.'
}
throw $failureMessage
}
[pscustomobject]$result
+11
View File
@@ -124,10 +124,21 @@ if (-not $verifiedPasswordNeverExpires) {
throw "The local account '$userName' password is not configured to never expire."
}
$localProfilePolicyScript = Join-Path $PSScriptRoot 'Set-SguLocalProfileSecurityPolicies.ps1'
if (-not (Test-Path -LiteralPath $localProfilePolicyScript -PathType Leaf)) {
throw 'Set-SguLocalProfileSecurityPolicies.ps1 must be beside Set-SguStandardLocalUser.ps1.'
}
$localProfilePolicy = & $localProfilePolicyScript
if (-not $localProfilePolicy.IsValid) {
throw 'The local profile security policy did not reach every local user profile.'
}
[pscustomobject]@{
UserName = $verifiedUser.Name
Enabled = $verifiedUser.Enabled
IsAdministrator = $false
IsStandardUser = $true
PasswordNeverExpires = $verifiedPasswordNeverExpires
DisableLockWorkstationForAllLocalProfiles = [bool]$localProfilePolicy.IsValid
LocalProfilesSecured = @($localProfilePolicy.LocalProfiles).Count
}
+115 -9
View File
@@ -2,6 +2,8 @@
[CmdletBinding()]
param(
[string]$BaseImagePath = (Join-Path $env:ProgramData 'SGU\Branding\darkblue.jpg'),
[string]$AdministrativeBaseImagePath = (Join-Path $env:ProgramData 'SGU\Branding\darkgray-administrative.png'),
[string]$ProfessorBaseImagePath = (Join-Path $env:ProgramData 'SGU\Branding\darkred-professor.png'),
[string]$FontsPath = (Join-Path $env:ProgramData 'SGU\Branding\fonts'),
[string]$OutputPath,
[string]$DisplayName,
@@ -10,6 +12,8 @@ param(
[string]$OrganizationalUnit,
[ValidateSet('Male', 'Female')]
[string]$Gender,
[ValidateSet('Administrative', 'Professor')]
[string]$InstitutionalRole,
[ValidateRange(640, 16384)]
[int]$CanvasWidth,
[ValidateRange(480, 16384)]
@@ -249,6 +253,92 @@ function Get-WelcomeHeading {
}
}
function Get-SguSessionInstitutionalRole {
# The role comes from the logon token rather than a directory query. That
# keeps the correct institutional base available when a domain controller
# is temporarily unavailable after an interactive sign-in.
try {
$identity = [Security.Principal.WindowsIdentity]::GetCurrent()
$roles = @()
foreach ($groupSid in @($identity.Groups)) {
try {
$accountName = [string]$groupSid.Translate([Security.Principal.NTAccount]).Value
$groupName = ($accountName -split '\\')[-1]
if ([string]::Equals($groupName, 'SGU-Administrativos', [StringComparison]::OrdinalIgnoreCase)) {
$roles += 'Administrative'
}
elseif ([string]::Equals($groupName, 'SGU-Docentes', [StringComparison]::OrdinalIgnoreCase)) {
$roles += 'Professor'
}
}
catch {
# A stale or unresolved SID must not prevent desktop startup.
}
}
$roles = @($roles | Select-Object -Unique)
if ($roles.Count -eq 1) {
return [string]$roles[0]
}
if ($roles.Count -gt 1) {
Write-WelcomeLog -Message 'WARN Multiple SGU role groups were present; using the neutral desktop base.'
}
}
catch {
Write-WelcomeLog -Message ('WARN SGU role lookup was unavailable: ' + $_.Exception.Message)
}
return $null
}
function Resolve-SguWelcomeBaseImage {
param(
[Parameter(Mandatory)][string]$DefaultPath,
[string]$AdministrativePath,
[string]$ProfessorPath,
[string]$Role
)
$rolePath = switch ($Role) {
'Administrative' { $AdministrativePath; break }
'Professor' { $ProfessorPath; break }
default { $null }
}
if ($rolePath -and (Test-Path -LiteralPath $rolePath -PathType Leaf)) {
return $rolePath
}
if ($rolePath) {
Write-WelcomeLog -Message ("WARN The {0} wallpaper base is missing; using the neutral base." -f $Role)
}
return $DefaultPath
}
function Get-SguWelcomePalette {
param([string]$Role)
switch ($Role) {
'Professor' {
return [pscustomobject]@{
Panel = [Drawing.Color]::FromArgb(82, 45, 0, 9)
Accent = [Drawing.Color]::FromArgb(255, 255, 226, 232)
Line = [Drawing.Color]::FromArgb(160, 255, 226, 232)
}
}
'Administrative' {
return [pscustomobject]@{
Panel = [Drawing.Color]::FromArgb(82, 8, 8, 8)
Accent = [Drawing.Color]::FromArgb(255, 238, 238, 238)
Line = [Drawing.Color]::FromArgb(160, 238, 238, 238)
}
}
default {
return [pscustomobject]@{
Panel = [Drawing.Color]::FromArgb(72, 0, 13, 58)
Accent = [Drawing.Color]::FromArgb(255, 211, 226, 255)
Line = [Drawing.Color]::FromArgb(155, 211, 226, 255)
}
}
}
}
function Get-AvailableFontFamily {
param(
[Parameter(Mandatory)][string[]]$Candidates,
@@ -311,10 +401,6 @@ trap {
throw
}
if (-not (Test-Path -LiteralPath $BaseImagePath -PathType Leaf)) {
throw "The welcome wallpaper base image does not exist: $BaseImagePath"
}
$userName = [Environment]::UserName
$metadata = $null
$machineLocation = [Environment]::GetEnvironmentVariable('SGU_WELCOME_LOCATION', 'Machine')
@@ -340,6 +426,22 @@ if (-not $PSBoundParameters.ContainsKey('DisplayName')) {
if (-not $DisplayName) {
$DisplayName = $userName
}
if (-not $PSBoundParameters.ContainsKey('InstitutionalRole')) {
$detectedInstitutionalRole = Get-SguSessionInstitutionalRole
# Like Gender, InstitutionalRole is ValidateSet-bound. Do not assign a
# missing token role because PowerShell validates even an explicit $null.
if ($detectedInstitutionalRole -in @('Administrative', 'Professor')) {
$InstitutionalRole = $detectedInstitutionalRole
}
}
$selectedBaseImagePath = Resolve-SguWelcomeBaseImage `
-DefaultPath $BaseImagePath `
-AdministrativePath $AdministrativeBaseImagePath `
-ProfessorPath $ProfessorBaseImagePath `
-Role $InstitutionalRole
if (-not (Test-Path -LiteralPath $selectedBaseImagePath -PathType Leaf)) {
throw "The welcome wallpaper base image does not exist: $selectedBaseImagePath"
}
if (-not $PSBoundParameters.ContainsKey('Location')) {
$Location = if ($machineLocation) { $machineLocation } elseif ($metadata) { $metadata.Location } else { $null }
}
@@ -386,7 +488,7 @@ if (-not $OutputPath) {
}
New-Item -ItemType Directory -Path (Split-Path $OutputPath -Parent) -Force | Out-Null
$source = [Drawing.Image]::FromFile($BaseImagePath)
$source = [Drawing.Image]::FromFile($selectedBaseImagePath)
$canvas = [Drawing.Bitmap]::new($CanvasWidth, $CanvasHeight, [Drawing.Imaging.PixelFormat]::Format24bppRgb)
try {
$graphics = [Drawing.Graphics]::FromImage($canvas)
@@ -424,10 +526,11 @@ try {
$panelHeight = [single](310 * $scale)
$panelX = [single](($CanvasWidth - $panelWidth) / 2)
$panelY = [single]($CanvasHeight * 0.50 - ($panelHeight / 2))
$panelBrush = [Drawing.SolidBrush]::new([Drawing.Color]::FromArgb(72, 0, 13, 58))
$palette = Get-SguWelcomePalette -Role $InstitutionalRole
$panelBrush = [Drawing.SolidBrush]::new($palette.Panel)
$whiteBrush = [Drawing.SolidBrush]::new([Drawing.Color]::White)
$accentBrush = [Drawing.SolidBrush]::new([Drawing.Color]::FromArgb(255, 211, 226, 255))
$linePen = [Drawing.Pen]::new([Drawing.Color]::FromArgb(155, 211, 226, 255), [single](2 * $scale))
$accentBrush = [Drawing.SolidBrush]::new($palette.Accent)
$linePen = [Drawing.Pen]::new($palette.Line, [single](2 * $scale))
$privateFonts = [Drawing.Text.PrivateFontCollection]::new()
if (Test-Path -LiteralPath $FontsPath -PathType Container) {
foreach ($fontFile in Get-ChildItem -LiteralPath $FontsPath -File |
@@ -536,13 +639,16 @@ namespace Sgu {
}
$genderLogValue = if ($Gender) { $Gender } else { 'Neutral' }
Write-WelcomeLog -Message ("OK computer={0}; gender={1}; location={2}; ou={3}; output={4}" -f $ComputerName,$genderLogValue,[bool]$Location,[bool]$OrganizationalUnit,$OutputPath)
$roleLogValue = if ($InstitutionalRole) { $InstitutionalRole } else { 'Neutral' }
Write-WelcomeLog -Message ("OK computer={0}; gender={1}; role={2}; location={3}; ou={4}; output={5}" -f $ComputerName,$genderLogValue,$roleLogValue,[bool]$Location,[bool]$OrganizationalUnit,$OutputPath)
[pscustomobject]@{
DisplayName = $DisplayName
ComputerName = $ComputerName
Location = $Location
OrganizationalUnit = $OrganizationalUnit
Gender = $Gender
InstitutionalRole = $InstitutionalRole
BaseImagePath = $selectedBaseImagePath
WelcomeHeading = $welcomeHeading
LocationText = $locationText
LocationPrimaryText = $locationPrimaryText
+53 -7
View File
@@ -8,6 +8,8 @@ set -uo pipefail
CONFIG_PATH=${SGU_WELCOME_CONFIG:-/etc/sgu/welcome-wallpaper.conf}
INSTALL_ROOT=${SGU_WELCOME_ROOT:-/usr/local/lib/sgu-welcome-wallpaper}
BASE_IMAGE=${SGU_WELCOME_BASE_IMAGE:-${INSTALL_ROOT}/darkblue.jpg}
ADMINISTRATIVE_BASE_IMAGE=${SGU_WELCOME_ADMINISTRATIVE_BASE_IMAGE:-${INSTALL_ROOT}/darkgray-administrative.png}
PROFESSOR_BASE_IMAGE=${SGU_WELCOME_PROFESSOR_BASE_IMAGE:-${INSTALL_ROOT}/darkred-professor.png}
if [[ -r $CONFIG_PATH ]]; then
# The root-owned file contains only deployment metadata, never credentials.
@@ -32,8 +34,6 @@ fail_softly() {
exit 0
}
[[ -r $BASE_IMAGE ]] || fail_softly "Missing base image: $BASE_IMAGE"
if command -v magick >/dev/null 2>&1; then
image_command=(magick)
elif command -v convert >/dev/null 2>&1; then
@@ -48,6 +48,40 @@ account_name=${account_name##*\\}
display_name=$(getent passwd "$raw_user" 2>/dev/null | awk -F: 'NR == 1 { split($5,a,","); print a[1] }')
[[ -n $display_name ]] || display_name=$account_name
# The SSSD/PAM token carries the institutional role at logon. Select the
# branded base without a second directory request; AL and unknown accounts
# intentionally retain the standard blue image.
institutional_role=''
session_groups=$(id -nG "$raw_user" 2>/dev/null || id -nG 2>/dev/null || true)
administrative_group=false
professor_group=false
for group in $session_groups; do
group=${group##*\\}
group=${group%@*}
case "${group,,}" in
sgu-administrativos) administrative_group=true ;;
sgu-docentes) professor_group=true ;;
esac
done
if [[ $administrative_group == true && $professor_group == false ]]; then
institutional_role='Administrative'
if [[ -r $ADMINISTRATIVE_BASE_IMAGE ]]; then
BASE_IMAGE=$ADMINISTRATIVE_BASE_IMAGE
else
log_message 'WARN Administrative wallpaper base is missing; using the neutral base.'
fi
elif [[ $professor_group == true && $administrative_group == false ]]; then
institutional_role='Professor'
if [[ -r $PROFESSOR_BASE_IMAGE ]]; then
BASE_IMAGE=$PROFESSOR_BASE_IMAGE
else
log_message 'WARN Professor wallpaper base is missing; using the neutral base.'
fi
elif [[ $administrative_group == true || $professor_group == true ]]; then
log_message 'WARN Multiple SGU role groups were present; using the neutral desktop base.'
fi
[[ -r $BASE_IMAGE ]] || fail_softly "Missing base image: $BASE_IMAGE"
computer_name=$(hostname -s 2>/dev/null || true)
computer_name=${computer_name^^}
location=''
@@ -264,23 +298,35 @@ if [[ $serif_font == DejaVu-Serif ]] && command -v fc-list >/dev/null 2>&1; then
fi
fi
panel_fill='rgba(0,13,58,0.30)'
accent_color='#D3E2FF'
case "$institutional_role" in
Professor)
panel_fill='rgba(45,0,9,0.38)'
accent_color='#FFE2E8'
;;
Administrative)
panel_fill='rgba(8,8,8,0.38)'
accent_color='#EEEEEE'
;;
esac
location_annotations=(
-font "$sans_font" -weight 400 -style Normal -pointsize "$location_size"
-fill '#D3E2FF' -stroke none -annotate "+0+$(( 76 * scale / 100 ))" "$location_primary"
-fill "$accent_color" -stroke none -annotate "+0+$(( 76 * scale / 100 ))" "$location_primary"
)
if [[ -n $location_secondary ]]; then
location_annotations+=(
-font "$sans_font" -weight 400 -style Normal -pointsize "$location_secondary_size"
-fill '#D3E2FF' -stroke none -annotate "+0+$(( 116 * scale / 100 ))" "$location_secondary"
-fill "$accent_color" -stroke none -annotate "+0+$(( 116 * scale / 100 ))" "$location_secondary"
)
fi
if ! "${image_command[@]}" "$BASE_IMAGE" \
-resize "${width}x${height}^" -gravity center -extent "${width}x${height}" \
-fill 'rgba(0,13,58,0.30)' -draw "rectangle ${panel_x1},${panel_y1} ${panel_x2},${panel_y2}" \
-fill "$panel_fill" -draw "rectangle ${panel_x1},${panel_y1} ${panel_x2},${panel_y2}" \
-gravity center \
-font "$sans_font" -weight 700 -style Normal -pointsize "$welcome_size" \
-fill '#D3E2FF' -stroke 'rgba(0,0,0,0.48)' -strokewidth 1 \
-fill "$accent_color" -stroke 'rgba(0,0,0,0.48)' -strokewidth 1 \
-annotate "+0-$(( 92 * scale / 100 ))" "$welcome_text" \
-font "$serif_font" -weight 700 -style Italic -pointsize "$name_size" \
-fill white -annotate "+0-$(( 22 * scale / 100 ))" "$display_name" \
@@ -312,7 +358,7 @@ if [[ $applied == false ]] && command -v xfconf-query >/dev/null 2>&1; then
fi
if [[ $applied == true ]]; then
log_message "OK computer=${computer_name}; gender=${gender:-Neutral}; location=$([[ -n $location ]] && printf true || printf false); ou=$([[ -n $organizational_unit ]] && printf true || printf false); output=${output_path}"
log_message "OK computer=${computer_name}; gender=${gender:-Neutral}; role=${institutional_role:-Neutral}; location=$([[ -n $location ]] && printf true || printf false); ou=$([[ -n $organizational_unit ]] && printf true || printf false); output=${output_path}"
else
log_message 'WARN Wallpaper rendered, but no supported desktop background API was found.'
fi
+16
View File
@@ -18,6 +18,7 @@ $classRegistryPath = "HKLM:\SOFTWARE\Classes\CLSID\$providerClassId\InprocServer
$defaultProviderPolicyPath = 'HKLM:\SOFTWARE\Policies\Microsoft\Windows\System'
$interactiveLogonPolicyPath = 'HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\Policies\System'
$settingsPath = Join-Path $env:ProgramData 'SGU\CredentialProvider\settings.json'
$localProfilePolicyStatePath = Join-Path $env:ProgramData 'SGU\Enrollment\local-profile-security-policy.json'
$issues = [Collections.Generic.List[string]]::new()
$standardLocalUserName = 'alumno'
$passwordNeverExpiresFlag = 0x10000
@@ -120,6 +121,20 @@ if (-not $localUserEnumerationDisabled) {
$issues.Add('Local user enumeration is not explicitly disabled for the domain client.')
}
$localProfileLockingConfigured = $false
try {
$localProfilePolicyState = Get-Content -LiteralPath $localProfilePolicyStatePath -Raw | ConvertFrom-Json
$localProfileLockingConfigured = [bool]$localProfilePolicyState.IsValid -and
[bool]$localProfilePolicyState.DefaultProfileConfigured -and
@($localProfilePolicyState.LocalProfiles | Where-Object { -not $_.DisableLockWorkstation }).Count -eq 0
}
catch {
# The enrollment report below identifies the absent system-worker verification state.
}
if (-not $localProfileLockingConfigured) {
$issues.Add('DisableLockWorkstation is not configured for every local user profile and the default profile.')
}
$passwordProviderPreserved = Test-Path -LiteralPath $passwordProviderRegistryPath
if (-not $passwordProviderPreserved) {
$issues.Add('The built-in Microsoft password provider registration is missing.')
@@ -295,6 +310,7 @@ $result = [pscustomobject]@{
LastSignedInUserHidden = $lastSignedInUserHidden
FastUserSwitchingHidden = $fastUserSwitchingHidden
LocalUserEnumerationDisabled = $localUserEnumerationDisabled
LocalProfileLockingConfigured = $localProfileLockingConfigured
PasswordProviderPreserved = $passwordProviderPreserved
StandardLocalUserPresent = $standardLocalUserPresent
StandardLocalUserEnabled = $standardLocalUserEnabled
+1 -1
View File
@@ -161,7 +161,7 @@ app.MapPost("/v1/authenticate", async (
AuthenticationFlowOutcome.InvalidCredentials => Results.Json(
new ErrorResponse(
result.ErrorCode ?? "INVALID_INSTITUTIONAL_CREDENTIALS",
"Credenciales institucionales inválidas."),
"Usuario o contraseña incorrectos."),
statusCode: StatusCodes.Status401Unauthorized),
_ => Unavailable(context, result.ErrorCode)
@@ -16,12 +16,12 @@ public sealed class SguCredentialProvider : CredentialProviderBase
{
yield return new CredentialProviderLabelControl(
ControlKeys.ProviderLabel,
"La Salle · Acceso SGU");
"Acceso Institucional");
yield return new CredentialProviderLogoControl(
ControlKeys.ProviderLogo,
"Acceso institucional SGU",
"Acceso Institucional",
ProviderTileIcon.Create());
yield return new LargeLabelControl(ControlKeys.Heading, "Acceso institucional SGU")
yield return new LargeLabelControl(ControlKeys.Heading, "Iniciar sesión")
{
// Isolate the CPFT_LARGE_TEXT heading from the compact provider tile
// for the selected-layout variant. LogonUI still owns the typography.
@@ -29,8 +29,8 @@ public sealed class SguCredentialProvider : CredentialProviderBase
};
yield return new SmallLabelControl(
ControlKeys.InformationLabel,
"Usa tu clave institucional (DO, AL o AD + 6 dígitos) y contraseña.");
yield return new TextboxControl(ControlKeys.UserName, "Clave institucional");
"Escribe tu usuario institucional o de dominio y contraseña.");
yield return new TextboxControl(ControlKeys.UserName, "Usuario");
SecurePasswordTextboxControl password = new(ControlKeys.Password, "Contraseña");
yield return password;
yield return new SubmitButtonControl(ControlKeys.Submit, "Iniciar sesión", password);
@@ -43,7 +43,12 @@ public sealed class SguCredentialProvider : CredentialProviderBase
public override bool ShouldIncludeGenericTile() => true;
public override CredentialTile CreateGenericTile() => new SguCredentialTile(this);
public override CredentialTile CreateGenericTile()
{
SguCredentialTile tile = new(this);
DefaultTile = tile;
return tile;
}
public override CredentialTile2 CreateUserTile(CredentialProviderUser user) =>
new SguCredentialTile(this, user);
+72 -24
View File
@@ -34,9 +34,14 @@ internal sealed class SguCredentialTile : CredentialTile3
protected override CredentialResponseBase GetCredentials()
{
if (!UserIdentityClassifier.TryParse(userNameControl.Text, out UserIdentity? identity) || identity is null)
ProviderSettings settings = TryLoadDomainOnlySettings();
if (!TryGetWindowsLogonName(
userNameControl.Text,
settings.DomainNetbios,
out string domain,
out string userName))
{
return Failure("La clave debe usar DO, AL o AD seguido de seis dígitos.");
return Failure("Escribe un usuario válido.");
}
SecureString securePassword = passwordControl.Password;
@@ -45,10 +50,16 @@ internal sealed class SguCredentialTile : CredentialTile3
return Failure("La contraseña es requerida.");
}
// Ordinary Active Directory accounts go straight to Windows. Only an
// institutional key needs SGU validation and the account UPSERT.
if (!UserIdentityClassifier.TryParse(userNameControl.Text, out UserIdentity? identity) || identity is null)
{
return DomainCredential(domain, userName, securePassword);
}
string plainTextPassword = CopyToManagedString(securePassword);
try
{
ProviderSettings settings;
BrokerDecision decision;
try
{
@@ -61,33 +72,25 @@ internal sealed class SguCredentialTile : CredentialTile3
}
catch
{
settings = TryLoadDomainOnlySettings();
decision = BrokerDecision.Unavailable("LOCAL_CONFIGURATION_OR_TLS_ERROR");
}
if (decision.Kind == BrokerDecisionKind.InvalidCredentials)
if (decision.Kind == BrokerDecisionKind.Authorized)
{
return Failure("Credenciales institucionales inválidas.");
return DomainCredential(decision.Domain!, decision.UserName!, securePassword);
}
string domain = decision.Kind == BrokerDecisionKind.Authorized
? decision.Domain!
: settings.DomainNetbios;
string userName = decision.Kind == BrokerDecisionKind.Authorized
? decision.UserName!
: identity.UserName;
return new CredentialResponseSecure
{
IsSuccess = true,
StatusIcon = decision.Kind == BrokerDecisionKind.Unavailable ? StatusIcon.Warning : StatusIcon.None,
StatusText = decision.Kind == BrokerDecisionKind.Unavailable
? "Servicio institucional no disponible; Windows validará la última contraseña de dominio registrada."
: null,
Domain = domain,
Username = userName,
Password = securePassword
};
// An SGU rejection does not create an account. Pass the unchanged
// credential to Windows so an existing AD account with the same
// name can still authenticate. A non-existent account is rejected
// by the domain controller.
return DomainCredential(
domain,
userName,
securePassword,
decision.Kind == BrokerDecisionKind.Unavailable
? "El servicio institucional no está disponible; Windows validará la contraseña guardada en el dominio."
: null);
}
finally
{
@@ -111,6 +114,51 @@ internal sealed class SguCredentialTile : CredentialTile3
}
}
private static bool TryGetWindowsLogonName(
string? enteredName,
string defaultDomain,
out string domain,
out string userName)
{
domain = string.Empty;
userName = enteredName?.Trim() ?? string.Empty;
if (userName.Length is 0 or > 256 || userName.Any(char.IsControl))
{
return false;
}
int slash = userName.LastIndexOf('\\');
if (slash >= 0)
{
domain = userName[..slash];
userName = userName[(slash + 1)..];
if (domain.Length is 0 or > 256 || domain.Contains('\\') || userName.Length == 0)
{
return false;
}
}
else if (!userName.Contains('@'))
{
domain = defaultDomain;
}
return userName.Length > 0 && domain.Length <= 256 && !domain.Any(char.IsControl);
}
private static CredentialResponseSecure DomainCredential(
string domain,
string userName,
SecureString password,
string? statusText = null) => new()
{
IsSuccess = true,
StatusIcon = statusText is null ? StatusIcon.None : StatusIcon.Warning,
StatusText = statusText,
Domain = domain,
Username = userName,
Password = password
};
private static CredentialResponseSecure Failure(string message) => new()
{
IsSuccess = false,
+41
View File
@@ -1,5 +1,6 @@
$repositoryRoot = (Resolve-Path (Join-Path $PSScriptRoot '..')).Path
$localUserScriptPath = Join-Path $repositoryRoot 'scripts\Set-SguStandardLocalUser.ps1'
$localProfilePolicyScriptPath = Join-Path $repositoryRoot 'scripts\Set-SguLocalProfileSecurityPolicies.ps1'
$enrollmentTestScriptPath = Join-Path $repositoryRoot 'scripts\Test-SguClientEnrollment.ps1'
$packageScriptPath = Join-Path $repositoryRoot 'scripts\New-SguBootstrapPackages.ps1'
$releaseScriptPath = Join-Path $repositoryRoot 'scripts\Publish-GiteaRelease.ps1'
@@ -17,6 +18,16 @@ if ($parseErrors.Count -gt 0) {
throw ($parseErrors -join [Environment]::NewLine)
}
$localProfilePolicyTokens = $null
$localProfilePolicyParseErrors = $null
[void][Management.Automation.Language.Parser]::ParseFile(
$localProfilePolicyScriptPath,
[ref]$localProfilePolicyTokens,
[ref]$localProfilePolicyParseErrors)
if ($localProfilePolicyParseErrors.Count -gt 0) {
throw ($localProfilePolicyParseErrors -join [Environment]::NewLine)
}
$descriptionAssignment = $scriptAst.Find({
param($node)
$node -is [Management.Automation.Language.AssignmentStatementAst] -and
@@ -55,6 +66,23 @@ Describe 'SGU Windows client enrollment scripts' {
}).Count | Should Be 0
}
It 'applies DisableLockWorkstation to existing and future local users during enrollment' {
$localUserSource = Get-Content -LiteralPath $localUserScriptPath -Raw
$profilePolicySource = Get-Content -LiteralPath $localProfilePolicyScriptPath -Raw
$enrollmentSource = Get-Content -LiteralPath (Join-Path $repositoryRoot 'scripts\Enroll-SguDomainClient.ps1') -Raw
$packageSource = Get-Content -LiteralPath $packageScriptPath -Raw
$localUserSource | Should Match 'Set-SguLocalProfileSecurityPolicies\.ps1'
$profilePolicySource | Should Match "\$policyValueName = 'DisableLockWorkstation'"
$profilePolicySource | Should Match 'Get-LocalUser'
$profilePolicySource | Should Match 'NTUSER\.DAT'
$profilePolicySource | Should Match "-UserId 'SYSTEM'"
$profilePolicySource | Should Match 'Unregister-ScheduledTask'
$profilePolicySource | Should Match 'DefaultProfileConfigured'
$enrollmentSource | Should Match "'Set-SguLocalProfileSecurityPolicies\.ps1'"
$packageSource | Should Match "'Set-SguLocalProfileSecurityPolicies\.ps1'"
}
It 'publishes one Windows artifact with automatic compatibility' {
$packageSource = Get-Content -LiteralPath $packageScriptPath -Raw
$releaseSource = Get-Content -LiteralPath $releaseScriptPath -Raw
@@ -94,4 +122,17 @@ Describe 'SGU Windows client enrollment scripts' {
$policySource | Should Match "LockScreenImagePath.*WelcomeLockScreenBasePath"
$policySource | Should Match "LockScreenImageUrl.*WelcomeLockScreenBasePath"
}
It 'ships all role-specific wallpaper bases and passes them to the per-logon renderer' {
$installerSource = Get-Content -LiteralPath $credentialProviderInstallerPath -Raw
$policySource = Get-Content -LiteralPath $computerPolicyScriptPath -Raw
$packageSource = Get-Content -LiteralPath $packageScriptPath -Raw
foreach ($assetName in 'darkgray-administrative.png','darkred-professor.png') {
Test-Path -LiteralPath (Join-Path $repositoryRoot "assets\branding\$assetName") -PathType Leaf | Should Be $true
$installerSource | Should Match ([regex]::Escape($assetName))
$packageSource | Should Match ([regex]::Escape($assetName))
}
$policySource | Should Match 'AdministrativeBaseImagePath'
$policySource | Should Match 'ProfessorBaseImagePath'
}
}
+21
View File
@@ -0,0 +1,21 @@
$repositoryRoot = (Resolve-Path (Join-Path $PSScriptRoot '..')).Path
$policyPath = Join-Path $repositoryRoot 'scripts\Set-SguDomainComputerPolicies.ps1'
$packagePath = Join-Path $repositoryRoot 'scripts\New-SguBootstrapPackages.ps1'
$initializePath = Join-Path $repositoryRoot 'scripts\Initialize-SguDomainController.ps1'
$policy = Get-Content -LiteralPath $policyPath -Raw
$package = Get-Content -LiteralPath $packagePath -Raw
$initialize = Get-Content -LiteralPath $initializePath -Raw
Describe 'Managed Microsoft Edge laboratory policy' {
It 'suppresses onboarding, browser sign-in and cloud sync through mandatory machine policy' {
$policy | Should Match "edgePolicyKey = 'HKLM\\Software\\Policies\\Microsoft\\Edge'"
$policy | Should Match "Name = 'HideFirstRunExperience'; Type = 'DWord'; Value = 1"
$policy | Should Match "Name = 'BrowserSignin'; Type = 'DWord'; Value = 0"
$policy | Should Match "Name = 'SyncDisabled'; Type = 'DWord'; Value = 1"
}
It 'ships the policy script and invokes it during server initialization' {
$package | Should Match "'Set-SguDomainComputerPolicies.ps1'"
$initialize | Should Match 'Join-Path \$scriptsRoot ''Set-SguDomainComputerPolicies.ps1'''
}
}
@@ -22,6 +22,20 @@ Describe 'Laboratorio wallpaper policy packaging and scope' {
$policySource | Should Match ([regex]::Escape('%LOCALAPPDATA%\SGU\Wallpapers\welcome-%COMPUTERNAME%.jpg'))
$policySource | Should Match "Name = 'Wallpaper'; Type = 'ExpandString'"
}
It 'prevents every local or domain user on a laboratory machine from locking it' {
$policySource | Should Match "Name = 'DisableLockWorkstation'; Type = 'DWord'; Value = 1"
$policySource | Should Match "Name = 'ScreenSaveActive'; Type = 'String'; Value = '0'"
$policySource | Should Match 'local accounts such as \.\\ing'
$policySource | Should Match 'DisableLockWorkstationForAllUsers = \$true'
}
It 'runs the local-profile lock restriction as LocalSystem at computer startup' {
$policySource | Should Match 'Set-SguLocalProfileSecurityPolicies\.ps1'
$policySource | Should Match 'Join-Path \$scriptsRoot ''scripts\.ini'''
$policySource | Should Match 'Start-SguLocalProfileSecurityPolicies\.cmd'
$policySource | Should Match '-ExecutionPolicy Bypass'
$policySource | Should Match "RunsAs = 'LocalSystem'"
$policySource | Should Match 'gPCMachineExtensionNames'
}
It 'reuses and backs up an existing GPO and verifies the result' {
foreach ($command in @('Get-GPO', 'Backup-GPO', 'Set-GPLink', 'New-GPLink', 'Get-GPRegistryValue')) {
$policySource | Should Match ([regex]::Escape($command))
@@ -69,6 +69,29 @@ public sealed class AuthenticationWorkflowTests
Assert.Null(directory.Password);
}
[Fact]
public async Task EverySuccessfulSignInSynchronizesTheLatestPassword()
{
CapturingDirectorySynchronizer directory = new();
AuthenticationWorkflow workflow = new(
new CapturingNtlmValidator(NtlmValidationResult.Valid()),
directory);
_ = await workflow.AuthenticateAsync(
"AL123456",
"Contraseña-anterior-27!",
TestContext.Current.CancellationToken);
AuthenticationFlowResult result = await workflow.AuthenticateAsync(
"AL123456",
"Contraseña-nueva-28!",
TestContext.Current.CancellationToken);
Assert.Equal(AuthenticationFlowOutcome.Authorized, result.Outcome);
Assert.Equal(
["Contraseña-anterior-27!", "Contraseña-nueva-28!"],
directory.Passwords);
}
private sealed class CapturingNtlmValidator(NtlmValidationResult result) : INtlmCredentialValidator
{
public UserIdentity? Identity { get; private set; }
@@ -92,6 +115,8 @@ public sealed class AuthenticationWorkflowTests
public string? Password { get; private set; }
public List<string> Passwords { get; } = [];
public InstitutionalProfile? Profile { get; private set; }
public Task<DirectorySyncResult> SynchronizeAsync(
@@ -103,6 +128,7 @@ public sealed class AuthenticationWorkflowTests
Identity = identity;
Profile = profile;
Password = password;
Passwords.Add(password);
return Task.FromResult(new DirectorySyncResult(
"LCI",
identity.UserName,
@@ -14,11 +14,11 @@ internal static class Program
private static readonly string[] ExpectedLabels =
[
"La Salle · Acceso SGU",
"Acceso institucional SGU",
"Acceso institucional SGU",
"Usa tu clave institucional (DO, AL o AD + 6 dígitos) y contraseña.",
"Clave institucional",
"Acceso Institucional",
"Acceso Institucional",
"Iniciar sesión",
"Escribe tu usuario institucional o de dominio y contraseña.",
"Usuario",
"Contraseña",
"Iniciar sesión"
];
@@ -89,6 +89,8 @@ internal static class Program
bool passed = fieldCount == ExpectedLabels.Length &&
credentialCount == 1 &&
defaultIndex == 0 &&
autoLogon == 0 &&
credential != IntPtr.Zero &&
providerLogoPresent &&
!userTilePresent &&
@@ -146,7 +148,7 @@ internal static class Program
private static int RunSerializationProbe(string mode, IntPtr credential, IReadOnlyList<string> labels)
{
string[] labelArray = labels.ToArray();
uint userNameFieldId = checked((uint)Array.IndexOf(labelArray, "Clave institucional"));
uint userNameFieldId = checked((uint)Array.IndexOf(labelArray, "Usuario"));
uint passwordFieldId = checked((uint)Array.IndexOf(labelArray, "Contraseña"));
string userName = mode == "online-success"
? Environment.GetEnvironmentVariable("SGU_TEST_USERNAME")
@@ -184,7 +186,7 @@ internal static class Program
bool rejectionPassed = response == (int)SerializationResponse.NoCredentialNotFinished &&
serialization.SerializationData == IntPtr.Zero &&
statusIcon == (int)StatusIcon.Error &&
statusText == "Credenciales institucionales inválidas.";
statusText == "Usuario o contraseña incorrectos.";
Console.WriteLine(JsonSerializer.Serialize(new
{
passed = rejectionPassed,
@@ -216,7 +218,7 @@ internal static class Program
? serializedCredentialPassed && statusIcon == (int)StatusIcon.None && string.IsNullOrEmpty(statusText)
: serializedCredentialPassed &&
statusIcon == (int)StatusIcon.Warning &&
statusText == "Servicio institucional no disponible; Windows validará la última contraseña de dominio registrada.";
statusText == "El servicio de autenticación no está disponible; Windows validará la última contraseña de dominio registrada.";
Console.WriteLine(JsonSerializer.Serialize(new
{
passed,
@@ -55,8 +55,8 @@ public sealed class ProviderTileIconTests
LargeLabelControl heading = Assert.Single(controls.OfType<LargeLabelControl>());
SguCredentialTile tile = Assert.IsType<SguCredentialTile>(provider.CreateGenericTile());
Assert.Equal("La Salle · Acceso SGU", providerLabel.Label);
Assert.Equal("Acceso institucional SGU", heading.Label);
Assert.Equal("Acceso Institucional", providerLabel.Label);
Assert.Equal("Iniciar sesión", heading.Label);
Assert.Equal(FieldState.DisplayInSelectedTile, heading.State);
Assert.Equal(GenericTileDisplayMode.DisplayAsDedicatedTile, tile.GenericTileDisplayMode);
Assert.IsAssignableFrom<CredentialTile3>(tile);
+44 -1
View File
@@ -18,7 +18,8 @@ function Invoke-WelcomeFixture {
[string]$DirectoryLocation = 'Sala de pruebas',
[string]$DirectoryOu = 'Laboratorio',
[string]$MachineLocation,
[string]$MachineOu
[string]$MachineOu,
[string]$InstitutionalRole
)
# Replace only the external directory lookup. Execute the actual script,
@@ -37,6 +38,8 @@ function Invoke-WelcomeFixture {
[IO.File]::WriteAllText($testScript, $fixtureSource, [Text.UTF8Encoding]::new($false))
$parameters = @{
BaseImagePath = Join-Path $repositoryRoot 'assets\branding\darkblue.jpg'
AdministrativeBaseImagePath = Join-Path $repositoryRoot 'assets\branding\darkgray-administrative.png'
ProfessorBaseImagePath = Join-Path $repositoryRoot 'assets\branding\darkred-professor.png'
FontsPath = Join-Path $repositoryRoot 'assets\branding\fonts'
OutputPath = Join-Path $TestDrive ([IO.Path]::GetFileNameWithoutExtension($testScript) + '.jpg')
CanvasWidth = 640
@@ -44,6 +47,7 @@ function Invoke-WelcomeFixture {
SkipApply = $true
}
if ($ExplicitGender) { $parameters.Gender = $ExplicitGender }
if ($InstitutionalRole) { $parameters.InstitutionalRole = $InstitutionalRole }
$previousLocalAppData = $env:LOCALAPPDATA
$previousMachineLocation = $env:SGU_WELCOME_LOCATION
$previousMachineOu = $env:SGU_WELCOME_ORGANIZATIONAL_UNIT
@@ -81,6 +85,18 @@ Describe 'Welcome wallpaper with AD metadata' {
(Invoke-WelcomeFixture -DirectoryGender 'Male').WelcomeHeading | Should Be 'Bienvenido,'
}
It 'uses role-specific desktop bases while keeping unclassified users blue' {
$administrative = Invoke-WelcomeFixture -DirectoryGender $null -InstitutionalRole 'Administrative'
$professor = Invoke-WelcomeFixture -DirectoryGender $null -InstitutionalRole 'Professor'
$unclassified = Invoke-WelcomeFixture -DirectoryGender $null
$administrative.BaseImagePath | Should Be (Join-Path $repositoryRoot 'assets\branding\darkgray-administrative.png')
$administrative.InstitutionalRole | Should Be 'Administrative'
$professor.BaseImagePath | Should Be (Join-Path $repositoryRoot 'assets\branding\darkred-professor.png')
$professor.InstitutionalRole | Should Be 'Professor'
$unclassified.BaseImagePath | Should Be (Join-Path $repositoryRoot 'assets\branding\darkblue.jpg')
}
It 'honors an explicit gender over directory metadata' {
(Invoke-WelcomeFixture -DirectoryGender 'Female' -ExplicitGender 'Male').WelcomeHeading | Should Be 'Bienvenido,'
}
@@ -153,6 +169,33 @@ Describe 'Welcome wallpaper with AD metadata' {
}
}
It 'ships the administrative gray and professor red branded bases' {
foreach ($assetName in 'darkgray-administrative.png','darkred-professor.png') {
$assetPath = Join-Path $repositoryRoot "assets\branding\$assetName"
Test-Path -LiteralPath $assetPath -PathType Leaf | Should Be $true
$bitmap = [Drawing.Bitmap]::FromFile($assetPath)
try {
# Image generation may preserve the 16:10 composition with a
# slightly different absolute raster size. The renderer crops
# to the active display, so the invariant is the aspect ratio.
([Math]::Round($bitmap.Width / $bitmap.Height, 2)) | Should Be 1.6
$lowerRightWhitePixels = 0
for ($x = 1260; $x -lt 1510; $x += 2) {
for ($y = 740; $y -lt 860; $y += 2) {
$pixel = $bitmap.GetPixel($x, $y)
if ($pixel.R -gt 220 -and $pixel.G -gt 220 -and $pixel.B -gt 220) {
$lowerRightWhitePixels++
}
}
}
($lowerRightWhitePixels -gt 250) | Should Be $true
}
finally { $bitmap.Dispose() }
}
$source | Should Match 'SGU-Administrativos'
$source | Should Match 'SGU-Docentes'
}
It 'keeps the lock screen base free of the desktop logo' {
$bitmap = [Drawing.Bitmap]::FromFile((Join-Path $repositoryRoot 'assets\branding\darkblue-lockscreen.jpg'))
try {