Compare commits
72
Commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
656f1dd3bb | ||
|
|
5cda541e3d | ||
|
|
bfa520dec8 | ||
|
|
2cca02db35 | ||
|
|
b9756ad3b2 | ||
|
|
0dd4c4d629 | ||
|
|
046a815962 | ||
|
|
2c90802930 | ||
|
|
422071ca6a | ||
|
|
11d49dc245 | ||
|
|
46c0be732a | ||
|
|
b07dbe17d0 | ||
|
|
414a08ece6 | ||
|
|
80baae1b54 | ||
|
|
843a1956d6 | ||
|
|
738df9ceea | ||
|
|
77091c023d | ||
|
|
21890047e2 | ||
|
|
db35d86df1 | ||
|
|
63fbaf65dc | ||
|
|
6fb703b015 | ||
|
|
acfdcd5bbf | ||
|
|
771dc60f7d | ||
|
|
2e972a06bd | ||
|
|
42f405e69c | ||
|
|
ba2aca5c2a | ||
|
|
fd051dee80 | ||
|
|
c7c0f941d4 | ||
|
|
20dae3caa9 | ||
|
|
7d78a1f515 | ||
|
|
8290e347f5 | ||
|
|
4478753457 | ||
|
|
80ab99cc8a | ||
|
|
106be26e7c | ||
|
|
01e0ee5ac4 | ||
|
|
c47913e81d | ||
|
|
da310e4213 | ||
|
|
bda8b354b7 | ||
|
|
7986b76e35 | ||
|
|
7de6e2d867 | ||
|
|
7460f9316d | ||
|
|
351adb0bdc | ||
|
|
2de1105ecd | ||
|
|
6c52a9546c | ||
|
|
520b4be955 | ||
|
|
7f8a9eed4e | ||
|
|
74235ec6f8 | ||
|
|
0b510082d4 | ||
|
|
5e62a65316 | ||
|
|
1332f546fa | ||
|
|
14c919b380 | ||
|
|
a6bd625e4e | ||
|
|
8baa47fe1e | ||
|
|
a24c25a3fb | ||
|
|
991fc70600 | ||
|
|
93871b62b0 | ||
|
|
1fe2006404 | ||
|
|
7a4f599f55 | ||
|
|
0a2dbbeb93 | ||
|
|
f87495f21c | ||
|
|
5f5772f8cd | ||
|
|
a2ac027dc3 | ||
|
|
bb6bcf3e85 | ||
|
|
db395c9215 | ||
|
|
ef9be0f897 | ||
|
|
675db6bc1e | ||
|
|
b3ec649199 | ||
|
|
9f32ed2cb1 | ||
|
|
c737bd3192 | ||
|
|
dcbf5e87e3 | ||
|
|
f2a40f051b | ||
|
|
17c8960cdd |
No files matched your search
@@ -348,3 +348,6 @@ MigrationBackup/
|
|||||||
|
|
||||||
# Ionide (cross platform F# VS Code tools) working folder
|
# Ionide (cross platform F# VS Code tools) working folder
|
||||||
.ionide/
|
.ionide/
|
||||||
|
|
||||||
|
# Ejemplos de Usuarios
|
||||||
|
tmp/
|
||||||
@@ -9,24 +9,31 @@ source and adds an SGU-specific provider, an mTLS-protected broker, Active
|
|||||||
Directory synchronization, deployment scripts, and tests.
|
Directory synchronization, deployment scripts, and tests.
|
||||||
|
|
||||||
Ready-to-run bootstrap packages are published on the
|
Ready-to-run bootstrap packages are published on the
|
||||||
[releases page](https://github.lci.ulsa.mx/alexrg/SGU-CredentialProvider/releases).
|
[releases page](https://gitea.lci.ulsa.mx/alexrg/SGU-CredentialProvider/releases).
|
||||||
|
|
||||||
## Authentication contract
|
## Authentication contract
|
||||||
|
|
||||||
1. The Windows tile collects a `DO`, `AL`, or `AD` institutional key and a password.
|
1. Windows selects **Acceso Institucional** by default. The built-in
|
||||||
2. It sends that exact password over mutually authenticated TLS to the broker.
|
Microsoft password provider stays available for recovery.
|
||||||
3. The broker validates the same key/password pair against the lightweight SGU
|
2. Ordinary domain usernames go straight to Windows for Active Directory
|
||||||
NTLM root. Only an authoritative `401`/`403` rejects the credential.
|
authentication. A `DO`, `AL`, or `AD` key is checked against SGU first.
|
||||||
4. After successful authentication, the broker makes a separately bounded,
|
3. The tile sends recognized institutional keys and their exact passwords over
|
||||||
best-effort request for the minimum available SGU profile fields.
|
mutually authenticated TLS. After SGU accepts the credential, the broker
|
||||||
5. On success, the broker creates or moves the AD user, updates the available
|
performs an idempotent Active Directory UPSERT: it creates or repairs the
|
||||||
name/mail/title/department/address metadata when available, and sets the AD password
|
account, role OU and group, supported profile fields, and AD password.
|
||||||
to the exact submitted password.
|
4. If SGU rejects the key or is unavailable, the unchanged credentials go to
|
||||||
6. The Credential Provider serializes the original `SecureString` to Windows.
|
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,
|
No derived password is created. Passwords are not written to a database, file,
|
||||||
event log, application log, command line, or response.
|
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
|
For administrative accounts, profile enrichment first verifies the employee
|
||||||
number against the incident overview, then reads the structured given names and
|
number against the incident overview, then reads the structured given names and
|
||||||
surnames from `datos/personales.aspx` and the postal address from
|
surnames from `datos/personales.aspx` and the postal address from
|
||||||
@@ -44,19 +51,32 @@ skips that optional field. Missing or changed presentation HTML never blocks
|
|||||||
authentication or password synchronization after the lightweight NTLM root has
|
authentication or password synchronization after the lightweight NTLM root has
|
||||||
accepted the credential.
|
accepted the credential.
|
||||||
|
|
||||||
|
For administrative staff and professors, the location page is enriched with its
|
||||||
|
ASP.NET PageMethods responses. `GetDireccion` supplies the saved state,
|
||||||
|
municipality and neighborhood identifiers; `GetLocalidadListado` resolves the
|
||||||
|
municipality name, and `GetColoniasListado` validates or supplies the
|
||||||
|
neighborhood name. This avoids reading the temporary `Seleccione...` values
|
||||||
|
visible while the browser populates those controls asynchronously.
|
||||||
|
|
||||||
Operational documentation:
|
Operational documentation:
|
||||||
|
|
||||||
|
- [Centro de Experiencia Digital Wi-Fi policy and management](docs/ced-network-operations.md)
|
||||||
- [One-command server recovery and client enrollment](docs/bootstrap-recovery.md)
|
- [One-command server recovery and client enrollment](docs/bootstrap-recovery.md)
|
||||||
- [Broker location, health, timeout, and recovery](docs/broker-operations.md)
|
- [Broker location, health, timeout, and recovery](docs/broker-operations.md)
|
||||||
- [Windows domain join and remote-access onboarding](docs/windows-client-onboarding.md)
|
- [Windows domain join and remote-access onboarding](docs/windows-client-onboarding.md)
|
||||||
- [Required Credential Provider client enrollment](docs/client-enrollment.md)
|
- [Required Credential Provider client enrollment](docs/client-enrollment.md)
|
||||||
|
- [Linux client enrollment with realmd and SSSD](docs/linux-client-enrollment.md)
|
||||||
|
- [Self-hosted RustDesk server and managed Windows remote access](docs/rustdesk-operations.md)
|
||||||
|
- [Domain monitoring, usage reports, and six-month retention](docs/monitoring.md)
|
||||||
|
- [Laboratorio desktop wallpaper protection](docs/laboratorio-wallpaper-policy.md)
|
||||||
|
- [Optional Azure user roaming by role with Azure Files and FSLogix](docs/user-roaming.md)
|
||||||
- [Decision: do not persist password verifiers in Redis](docs/decisions/0001-no-password-cache.md)
|
- [Decision: do not persist password verifiers in Redis](docs/decisions/0001-no-password-cache.md)
|
||||||
|
|
||||||
| Prefix | Role | Default OU |
|
| Prefix | Role | Default OU | Security group in the same OU |
|
||||||
|---|---|---|
|
|---|---|---|---|
|
||||||
| `DO` | Professor / docente | `OU=Docentes,OU=Usuarios-SGU,DC=lci,DC=lasalle,DC=mx` |
|
| `DO` | Professor / docente | `OU=Docentes,OU=Usuarios-SGU,DC=lci,DC=lasalle,DC=mx` | `SGU-Docentes` |
|
||||||
| `AL` | Student / alumno | `OU=Alumnos,OU=Usuarios-SGU,DC=lci,DC=lasalle,DC=mx` |
|
| `AL` | Student / alumno | `OU=Alumnos,OU=Usuarios-SGU,DC=lci,DC=lasalle,DC=mx` | `SGU-Alumnos` |
|
||||||
| `AD` | Administrative | `OU=Administrativos,OU=Usuarios-SGU,DC=lci,DC=lasalle,DC=mx` |
|
| `AD` | Administrative | `OU=Administrativos,OU=Usuarios-SGU,DC=lci,DC=lasalle,DC=mx` | `SGU-Administrativos` |
|
||||||
|
|
||||||
If the broker or institutional NTLM authority is unavailable, the provider
|
If the broker or institutional NTLM authority is unavailable, the provider
|
||||||
submits the unchanged credentials to Windows for normal AD/cached-domain
|
submits the unchanged credentials to Windows for normal AD/cached-domain
|
||||||
@@ -94,17 +114,51 @@ the latest .NET 10 x64 runtime. The broker is published self-contained.
|
|||||||
Follow [docs/lab-runbook.md](docs/lab-runbook.md). Review
|
Follow [docs/lab-runbook.md](docs/lab-runbook.md). Review
|
||||||
[docs/security.md](docs/security.md) before production deployment and
|
[docs/security.md](docs/security.md) before production deployment and
|
||||||
[docs/architecture.md](docs/architecture.md) for the component contract.
|
[docs/architecture.md](docs/architecture.md) for the component contract.
|
||||||
|
For a public Azure VM, use
|
||||||
|
[docs/azure-vpn-deployment.md](docs/azure-vpn-deployment.md). It supports an
|
||||||
|
optional Azure P2S gateway or direct enrollment restricted to explicit public
|
||||||
|
source CIDRs. Every SGU role uses an ordinary local Windows profile by default:
|
||||||
|
Desktop and Documents stay under `C:\Users` and no profile share is mapped.
|
||||||
|
Azure Files/FSLogix roaming remains available only as an experimental,
|
||||||
|
explicit opt-in that requires acknowledgement of its login, sign-out, storage,
|
||||||
|
cache and recovery risks. See [docs/user-roaming.md](docs/user-roaming.md) for
|
||||||
|
the opt-in and rollback procedures.
|
||||||
|
|
||||||
Never disable the built-in Microsoft password Credential Provider. It is the
|
Never disable the built-in Microsoft password Credential Provider. It is the
|
||||||
supported recovery path if a third-party provider fails to load.
|
supported recovery path if a third-party provider fails to load.
|
||||||
|
|
||||||
For a clean machine, the supported entry points are the release packages:
|
For a clean Windows 10 or Windows 11 workstation, use the unified package:
|
||||||
|
|
||||||
|
- `sgu-windows-client-bootstrap-VERSION.zip` (x64 Pro, Enterprise or Education),
|
||||||
|
including optional Azure P2S setup for both versions.
|
||||||
|
|
||||||
|
Double-click `Start-SguClientEnrollment.cmd` and enter the server IP and domain
|
||||||
|
credentials, or provide the server IP on the command line:
|
||||||
|
|
||||||
```bat
|
```bat
|
||||||
Start-SguServerBootstrap.cmd 192.168.50.10
|
Start-SguServerBootstrap.cmd 192.168.50.10
|
||||||
Start-SguClientEnrollment.cmd 192.168.50.10
|
Start-SguClientEnrollment.cmd 192.168.50.10
|
||||||
```
|
```
|
||||||
|
|
||||||
|
El bootstrap prueba interfaces y rutas hacia el servidor, incluyendo VPN ya
|
||||||
|
conectadas, sin pedir la IP del cliente ni exigir la misma subred. Conserva DHCP
|
||||||
|
y el DNS de Internet; descubre el dominio autenticado y configura DNS sólo para
|
||||||
|
ese dominio. Si recibe una IP pública, configura DoH y los nombres necesarios de
|
||||||
|
AD después de autenticar al servidor. El segmento público del cliente debe estar
|
||||||
|
autorizado en el servidor y su firewall perimetral. Los casos sin DHCP o sin ruta
|
||||||
|
muestran un diagnóstico.
|
||||||
|
Ver [client-enrollment.md](docs/client-enrollment.md) para requisitos y parámetros
|
||||||
|
avanzados de IP estática.
|
||||||
|
|
||||||
|
Linux clients are enrolled through their native PAM/SSSD stack instead of the
|
||||||
|
Windows Credential Provider:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
sudo bash ./Enroll-SguLinuxDomainClient.sh \
|
||||||
|
--domain-controller 192.168.50.10 \
|
||||||
|
--enable-hyperv-enhanced-session
|
||||||
|
```
|
||||||
|
|
||||||
The server command creates a new forest and resumes by itself after its required
|
The server command creates a new forest and resumes by itself after its required
|
||||||
restart. The client command registers a unique non-exportable mTLS certificate,
|
restart. The client command registers a unique non-exportable mTLS certificate,
|
||||||
installs and validates SGU before domain join, then enables the managed remote
|
installs and validates SGU before domain join, then enables the managed remote
|
||||||
|
|||||||
Binary file not shown.
|
After Width: | Height: | Size: 99 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 80 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 1.1 MiB |
Binary file not shown.
|
After Width: | Height: | Size: 1.1 MiB |
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
|
After Width: | Height: | Size: 1.1 MiB |
Binary file not shown.
|
After Width: | Height: | Size: 90 KiB |
+124
-25
@@ -23,13 +23,19 @@ is forced because NTLM authentication is connection-bound.
|
|||||||
The authoritative logical GET is sent to `/psulsa/`, a lightweight route that
|
The authoritative logical GET is sent to `/psulsa/`, a lightweight route that
|
||||||
returns the NTLM challenge without waiting for the slow application pages. A
|
returns the NTLM challenge without waiting for the slow application pages. A
|
||||||
`401` or `403` rejects the credential; an allowed `2xx` or `3xx` proves that IIS
|
`401` or `403` rejects the credential; an allowed `2xx` or `3xx` proves that IIS
|
||||||
accepted it. The broker then makes a separately bounded, best-effort GET to the
|
accepted it. The broker then makes separately bounded, best-effort profile GETs.
|
||||||
administrative incident overview for `AD`, the student information page for
|
It uses the administrative incident overview for `AD`, the student information
|
||||||
`AL`, or the portal menu for `DO`. After the incident page confirms an `AD`
|
page for `AL`, and the portal menu as a conservative base for `DO`. After the
|
||||||
employee number, two additional GETs in the same in-memory session read the
|
incident page confirms an `AD` employee number, two additional GETs in the same
|
||||||
structured name from `datos/personales.aspx` and the address from
|
in-memory session read the structured name and selected sex from
|
||||||
`datos/ubicacion.aspx`. Docentes keep the menu name as a base and attempt those
|
`datos/personales.aspx` and the address inputs from `datos/ubicacion.aspx`. The
|
||||||
same two shared staff modules without requiring them to exist. A supplemental
|
broker then calls the location page's `GetDireccion`, `GetLocalidadListado`, and
|
||||||
|
`GetColoniasListado` methods to correlate the saved state, municipality, and
|
||||||
|
neighborhood identifiers instead of reading transient `Seleccione...` options.
|
||||||
|
Docentes request
|
||||||
|
`nomina/consultanomina.aspx` for a matching employee number, email, employee
|
||||||
|
type and job title, then attempt the same two shared staff modules without
|
||||||
|
requiring any optional route to exist. A supplemental
|
||||||
404, changed/missing element ID, other failure, or timeout preserves fields
|
404, changed/missing element ID, other failure, or timeout preserves fields
|
||||||
already collected, and a profile timeout does not invalidate an already
|
already collected, and a profile timeout does not invalidate an already
|
||||||
authenticated credential. NTLM may still require its normal
|
authenticated credential. NTLM may still require its normal
|
||||||
@@ -46,29 +52,88 @@ Broker timeout, TLS failure, 429, or 5xx
|
|||||||
-> only the last AD password succeeds
|
-> only the last AD password succeeds
|
||||||
```
|
```
|
||||||
|
|
||||||
An explicit `400` or `401` from the broker is different: the provider displays
|
An explicit `400` or `401` from SGU does not create or update an account. The
|
||||||
an error and does not serialize the rejected credential.
|
tile submits the unchanged credentials to Windows, which accepts them only if
|
||||||
|
they match an existing Active Directory account.
|
||||||
|
|
||||||
## Account synchronization
|
## Account synchronization
|
||||||
|
|
||||||
The broker normalizes the username to uppercase and accepts exactly two letters
|
The visible Windows experience is one **Acceso Institucional** sign-in tile,
|
||||||
plus six digits. It searches `BaseDn` by `sAMAccountName`, creates the user when
|
selected by default, with `Usuario` and `Contraseña`. Ordinary usernames go
|
||||||
absent, moves it to the mapped OU when required, sets `userPrincipalName`, and
|
straight to Windows for domain authentication. A `DO`, `AL`, or `AD` key is
|
||||||
passes the submitted password directly to ADSI `SetPassword`.
|
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 explicitly rejects the credential, the provider stops without trying AD.
|
||||||
|
If SGU accepts it but AD synchronization fails, the provider reports that
|
||||||
|
failure without trying a stale AD verifier. Only a genuine broker/SGU outage
|
||||||
|
uses the documented Windows cached-domain-credential fallback, for an existing
|
||||||
|
account. A matching username pattern alone never provisions an account.
|
||||||
|
|
||||||
|
The domain bootstrap creates a fine-grained password policy for the three SGU
|
||||||
|
role security groups. It allows the broker to record the exact password SGU
|
||||||
|
accepted even when the normal domain complexity policy would reject it, while
|
||||||
|
keeping reversible password storage disabled. The domain default remains
|
||||||
|
unchanged. Bootstrap clears the per-user reversible-storage flag for members of
|
||||||
|
the three SGU groups, and the broker clears it before every password
|
||||||
|
synchronization. Existing reversibly stored passwords remain so until the next
|
||||||
|
password reset; successful Acceso SGU sign-in synchronizes the password using
|
||||||
|
the disabled setting.
|
||||||
|
|
||||||
|
Before an account becomes usable, the broker applies explicit deny ACEs for the
|
||||||
|
Active Directory `Change Password` extended right to SELF and Everyone. Users
|
||||||
|
beneath `OU=Usuarios-SGU` therefore cannot replace the synchronized password
|
||||||
|
from Windows, Ctrl+Alt+Delete, LDAP or another client. The broker's
|
||||||
|
administrative `SetPassword` operation uses the separate `Reset Password` right
|
||||||
|
and remains able to synchronize the current institutional credential after each
|
||||||
|
successful SGU authentication. Repeated synchronizations detect the existing
|
||||||
|
ACEs and do not duplicate them.
|
||||||
|
|
||||||
When the authenticated HTML exposes recognized stable IDs, the broker also
|
When the authenticated HTML exposes recognized stable IDs, the broker also
|
||||||
updates the applicable `displayName`, `givenName`, `sn`, `mail`, `title`,
|
updates the applicable `displayName`, `givenName`, `sn`, `mail`, `title`,
|
||||||
`department`, `employeeType`, `employeeID`, `streetAddress`, `l`, `st`, and
|
`department`, `employeeType`, `employeeID`, `streetAddress`, `l`, `st`, and
|
||||||
`postalCode` attributes. Administrative and student numbers must match the six
|
`postalCode` attributes. The SGU sex value is normalized to `Male`/`Female` and
|
||||||
|
written as the managed `SGU-Gender:` line in the built-in `info` attribute while
|
||||||
|
preserving unrelated notes. Administrative and student numbers must match the six
|
||||||
numeric digits of the requested identity before any role-specific metadata is
|
numeric digits of the requested identity before any role-specific metadata is
|
||||||
trusted. Administrative personal and location pages are accepted only after
|
trusted. Administrative personal and location pages are accepted only after
|
||||||
that incident-page match. A docente's supplemental fields remain tied to the
|
that incident-page match. Docente payroll metadata must match the requested
|
||||||
fresh NTLM-authenticated portal session and are optional; the menu display name
|
six-digit number; all docente supplemental fields remain tied to the fresh
|
||||||
remains usable if neither shared page is available. Student faculty/department
|
NTLM-authenticated portal session and are optional. The menu display name
|
||||||
|
remains usable if the payroll or shared staff pages are unavailable. Student faculty/department
|
||||||
is deliberately left unset because the verified page does not expose it.
|
is deliberately left unset because the verified page does not expose it.
|
||||||
Missing metadata does not clear existing AD values and never changes the
|
Missing metadata does not clear existing AD values and never changes the
|
||||||
password outcome.
|
password outcome.
|
||||||
|
|
||||||
|
## Optional Azure user roaming
|
||||||
|
|
||||||
|
The default architecture uses local Windows profiles for every role. Desktop,
|
||||||
|
Documents and the remainder of the profile live under `C:\Users`; enrollment
|
||||||
|
does not map a profile share and the domain GPO keeps FSLogix disabled.
|
||||||
|
|
||||||
|
An experimental opt-in can add a dedicated Azure Files account. Student
|
||||||
|
accounts (`AL`) redirect only Documents/Desktop, while administrative and
|
||||||
|
professor accounts (`AD`/`DO`) receive an FSLogix VHDX profile container through
|
||||||
|
object-specific settings. Enabling it is never implicit: both infrastructure
|
||||||
|
deployment and policy configuration require an explicit risk acknowledgement.
|
||||||
|
The storage account uses AD DS Kerberos with AES-256 and share-root ACLs use
|
||||||
|
`CREATOR OWNER`. See [user-roaming.md](user-roaming.md) for the observed
|
||||||
|
sign-out/cache failure modes, staged rollout requirements and rollback.
|
||||||
|
|
||||||
|
Every synchronization also enforces one idempotent security-group membership
|
||||||
|
from the classified institutional prefix: `AL` to `SGU-Alumnos`, `AD` to
|
||||||
|
`SGU-Administrativos`, and `DO` to `SGU-Docentes`. Each role group is stored
|
||||||
|
inside its corresponding user OU. During an upgrade,
|
||||||
|
the bootstrap moves a legacy group from the `Usuarios-SGU` root while preserving
|
||||||
|
its SID and memberships instead of creating a duplicate. Membership enforcement
|
||||||
|
happens synchronously inside the broker before the institutional password is written to AD. A missing
|
||||||
|
or inaccessible role group therefore fails provisioning instead of leaving a
|
||||||
|
new usable account without its authorization classification. Existing accounts
|
||||||
|
are repaired automatically on their next successful SGU authentication.
|
||||||
|
|
||||||
Human-readable SGU values are decoded with BOM/header/meta detection, strict
|
Human-readable SGU values are decoded with BOM/header/meta detection, strict
|
||||||
UTF-8 validation, and a Windows-1252 fallback for the legacy portal. Names and
|
UTF-8 validation, and a Windows-1252 fallback for the legacy portal. Names and
|
||||||
titles are normalized with Spanish-aware casing; particles such as `de`, `del`
|
titles are normalized with Spanish-aware casing; particles such as `de`, `del`
|
||||||
@@ -81,9 +146,10 @@ Windows client maps the group into its local **Remote Desktop Users** group.
|
|||||||
Every synchronized user also receives `La Salle` in the AD
|
Every synchronized user also receives `La Salle` in the AD
|
||||||
`company` attribute unless deployment configuration supplies another default.
|
`company` attribute unless deployment configuration supplies another default.
|
||||||
|
|
||||||
The generic SGU credential is rendered as a dedicated branded tile instead of
|
The generic Acceso Institucional credential is rendered as a dedicated
|
||||||
being grouped below the anonymous **Other user** tile. Machine policy assigns
|
branded tile instead of being grouped below the anonymous **Other user** tile.
|
||||||
the SGU CLSID as the default provider, hides the last signed-in identity, and
|
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
|
disables local-user enumeration while retaining the built-in Microsoft password
|
||||||
provider and its **Other user** recovery path. The computer GPO also applies
|
provider and its **Other user** recovery path. The computer GPO also applies
|
||||||
Windows' native default account picture to named Windows accounts; client
|
Windows' native default account picture to named Windows accounts; client
|
||||||
@@ -99,11 +165,44 @@ synthetic Windows account to imitate that title or ordering.
|
|||||||
The managed hierarchy is rooted at `OU=Usuarios-SGU`: `Docentes`, `Alumnos`,
|
The managed hierarchy is rooted at `OU=Usuarios-SGU`: `Docentes`, `Alumnos`,
|
||||||
and `Administrativos` are direct child OUs beneath it. The domain GPO
|
and `Administrativos` are direct child OUs beneath it. The domain GPO
|
||||||
`SGU - User session restrictions` is linked to this root and enables the
|
`SGU - User session restrictions` is linked to this root and enables the
|
||||||
per-user `DisableLockWorkstation` policy and disables screen savers for the
|
per-user `DisableLockWorkstation` and `DisableChangePassword` policies and
|
||||||
complete hierarchy. The computer GPO `SGU - Windows client experience` is linked
|
disables screen savers for the complete hierarchy. The enforced laboratory
|
||||||
to `OU=Laboratorio`; it suppresses first-logon/privacy/diagnostic prompts,
|
loopback GPO also applies `DisableLockWorkstation` and disables screen savers
|
||||||
disables location, and enforces always-on display, sleep, and hibernation
|
for domain accounts. Its computer-startup script runs as `LocalSystem` and
|
||||||
settings for managed clients.
|
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
|
||||||
|
managed `SGU-Gender: Male|Female` line from the user's built-in `info` attribute
|
||||||
|
(without requiring an irreversible AD schema extension). It uses neutral Spanish
|
||||||
|
when that optional enrichment is unavailable. The renderer also reads the
|
||||||
|
authenticated user's `displayName` plus the computer object's `location` and
|
||||||
|
immediate parent OU, then composes those values over the bundled dark-blue
|
||||||
|
background with the bundled Indivisa fonts. Missing directory attributes degrade
|
||||||
|
to deterministic text and never block the interactive session.
|
||||||
|
|
||||||
|
The domain controller is also the source-initiated Windows Event Collector for
|
||||||
|
managed laboratory computers. Kerberos-authenticated WEF sends only selected
|
||||||
|
logon/logoff, failed-logon, reconnect/disconnect, and operating-system power
|
||||||
|
events to `ForwardedEvents`. Daily EVTX archives are retained for 183 days, and
|
||||||
|
a five-minute server-side inventory records WinRM reachability and AD last-logon
|
||||||
|
metadata. Session-duration reports correlate Windows logon IDs; no password or
|
||||||
|
SGU HTTP payload is included in this monitoring path.
|
||||||
|
|
||||||
|
Broker diagnostics use the dedicated `SGU Auth Broker` Windows log with stable
|
||||||
|
event IDs for authorization outcomes, SGU network/timeout failures, unexpected
|
||||||
|
profile HTML, partial enrichment, and AD synchronization warnings. The same
|
||||||
|
daily maintenance task archives that log for 183 days. Messages identify the
|
||||||
|
institutional user and role but never include passwords, password verifiers, or
|
||||||
|
raw SGU HTML.
|
||||||
|
|
||||||
Per-user synchronization is serialized inside the broker to prevent concurrent
|
Per-user synchronization is serialized inside the broker to prevent concurrent
|
||||||
create/reset races. Production deployments should run the broker as a gMSA with
|
create/reset races. Production deployments should run the broker as a gMSA with
|
||||||
|
|||||||
@@ -0,0 +1,136 @@
|
|||||||
|
# Despliegue SGU en Azure y enrolamiento de Windows11-002
|
||||||
|
|
||||||
|
Fecha: 2026-09-10. Suscripción `1254ca0e-3950-4711-8b4b-e33b4677d950`.
|
||||||
|
|
||||||
|
## Infraestructura y bosque
|
||||||
|
|
||||||
|
| Componente | Configuración comprobada |
|
||||||
|
| --- | --- |
|
||||||
|
| Grupo de recursos / región | `rg-sgu-lab` / `centralus` |
|
||||||
|
| VM Azure / nombre Windows | `sgu-lab-dc` / `SGU-DC01` |
|
||||||
|
| Sistema y tamaño | Windows Server 2025 Azure Edition / `Standard_D2s_v5` |
|
||||||
|
| Dirección del controlador de dominio | `10.77.0.4` |
|
||||||
|
| Bosque / dominio / NetBIOS | `lci.lasalle.mx` / `lci.lasalle.mx` / `LCI` |
|
||||||
|
| SID del dominio Azure | `S-1-5-21-2324484875-464590158-1758545597` |
|
||||||
|
| VNet / pool P2S | `10.77.0.0/16` / `172.30.0.0/24` |
|
||||||
|
| Gateway | `sgu-lab-vpngw`, `VpnGw1AZ`, estado `Succeeded` |
|
||||||
|
| Protocolos configurados | IKEv2 y OpenVPN; prueba real con IKEv2 |
|
||||||
|
| Cliente Hyper-V / nombre Windows | `Windows11-002` / `DESKTOP-LM7D7OM` |
|
||||||
|
|
||||||
|
Se creó un bosque nuevo en Azure. Tiene el mismo nombre DNS que el bosque del
|
||||||
|
laboratorio local, pero una identidad distinta; no es una réplica ni una
|
||||||
|
migración de sus usuarios. El cliente de esta prueba consulta el bosque Azure
|
||||||
|
mediante una regla NRPT para `.lci.lasalle.mx`.
|
||||||
|
|
||||||
|
La promoción y la configuración SGU terminaron a las `22:10:36Z`. Se comprobó
|
||||||
|
`bootstrap-complete.json`, los servicios AD DS, DNS, ADWS, Netlogon y SGUAuthBroker,
|
||||||
|
los registros SRV y las pruebas dcdiag Connectivity, Advertising, SysVolCheck,
|
||||||
|
NetLogons y Services, todas con resultado satisfactorio. RustDesk, WinRM,
|
||||||
|
escritorio remoto y el colector de eventos quedaron configurados. Los puertos
|
||||||
|
administrativos y de AD no están abiertos a Internet.
|
||||||
|
|
||||||
|
## Enrolamiento y VPN
|
||||||
|
|
||||||
|
El cliente usa Windows 11 Enterprise LTSC x64, build 26100. Se creó el checkpoint
|
||||||
|
`Before-SGU-Azure-Enrollment-20260910` antes de modificarlo.
|
||||||
|
|
||||||
|
Se instaló un certificado de máquina y el perfil nativo `SGU Azure P2S`. Con el
|
||||||
|
túnel conectado, el bootstrap recibió la IP `10.77.0.4` y una credencial de dominio;
|
||||||
|
descubrió automáticamente dominio, NetBIOS, OU y la interfaz VPN `172.30.0.2`.
|
||||||
|
No recibió una IP del cliente ni una interfaz elegida manualmente.
|
||||||
|
|
||||||
|
El objeto `DESKTOP-LM7D7OM` quedó habilitado en
|
||||||
|
`OU=Laboratorio,DC=lci,DC=lasalle,DC=mx`. El proveedor SGU y sus certificados mTLS
|
||||||
|
quedaron instalados. La validación con dominio, broker, acceso remoto y RustDesk
|
||||||
|
exigidos devolvió `IsValid=True`, `Issues=[]`, `BrokerHealth=ok`,
|
||||||
|
`RemoteAccessReady=True` y `RustDeskReady=True`. El guard de enrolamiento terminó
|
||||||
|
con código 0.
|
||||||
|
|
||||||
|
Para este cliente Enterprise se instaló también `SGU Azure Device`, un perfil
|
||||||
|
VPNv2 de dispositivo bajo SYSTEM, con IKEv2, certificado de máquina, Always On y
|
||||||
|
ruta dividida `10.77.0.0/16`. El perfil manual permanece disponible. La NIC de
|
||||||
|
Internet conserva DHCP y DNS `172.18.176.1`; el túnel utiliza la dirección
|
||||||
|
`172.30.0.2` y la red del dominio.
|
||||||
|
|
||||||
|
La primera prueba de arranque del túnel detectó Netlogon 5719 y
|
||||||
|
`ERROR_NO_LOGON_SERVERS`: la red VPN estaba disponible después de que Netlogon
|
||||||
|
intentara localizar el dominio. Reiniciar únicamente Netlogon recuperó el canal
|
||||||
|
seguro sin restablecer la contraseña de máquina. Se probaron
|
||||||
|
`ExpectedDialupDelay=60` y `NegativeCachePeriod=3`, siguiendo la guía de Microsoft para
|
||||||
|
[conectividad de dominio tardía al arrancar](https://learn.microsoft.com/en-us/troubleshoot/windows-server/group-policy/netlogon-event-id-5719-or-group-policy-event-1129).
|
||||||
|
No resolvieron por sí solos esta VM; se devolvieron a sus valores predeterminados
|
||||||
|
0 y 45, respectivamente.
|
||||||
|
|
||||||
|
Se instaló `SGU-Azure-DomainConnectivity`, una tarea SYSTEM de arranque con
|
||||||
|
demora de 30 segundos y reintentos. Ejecuta
|
||||||
|
`scripts/Repair-SguAzureDomainConnectivity.ps1`: espera al perfil VPN y a LDAP
|
||||||
|
del controlador, comprueba el canal seguro y reinicia Netlogon únicamente si
|
||||||
|
es necesario. Después vuelve a ejecutar el guard SGU, espera su resultado y
|
||||||
|
reintenta fallos transitorios de resolución de grupos del dominio. No guarda credenciales
|
||||||
|
ni restablece automáticamente la contraseña de la cuenta de equipo. El
|
||||||
|
resultado se registra en
|
||||||
|
`C:\ProgramData\SGU\Enrollment\azure-domain-connectivity.json`.
|
||||||
|
|
||||||
|
La verificación final se realizó a las **17:00:55 UTC-6**, después del arranque
|
||||||
|
de las **16:57:35 UTC-6**, sin sesión interactiva (`UserName=null`):
|
||||||
|
|
||||||
|
- `SGU Azure Device=Connected`, `172.30.0.2`, red `DomainAuthenticated`.
|
||||||
|
- `Test-ComputerSecureChannel=True`; DC localizado en `10.77.0.4`.
|
||||||
|
- `IsValid=True`, sin incidencias; broker, acceso remoto y RustDesk correctos.
|
||||||
|
- `SGU-Azure-DomainConnectivity` terminó con código 0 y registró la recuperación
|
||||||
|
de Netlogon y `EnrollmentGuardResult=0`.
|
||||||
|
- `SGU-CredentialProvider-EnrollmentGuard` terminó con código 0.
|
||||||
|
- La captura muestra el acceso institucional SGU en la pantalla de inicio de
|
||||||
|
sesión. Se obtuvo directamente de Hyper-V, sin usar el escritorio del host.
|
||||||
|
|
||||||
|
En este arranque, la recuperación completa de dominio y guard terminó unos
|
||||||
|
dos minutos y medio después del inicio de Windows. No se comprobó un inicio de
|
||||||
|
sesión interactivo con un usuario institucional del nuevo bosque; se validaron
|
||||||
|
la unión, la confianza de máquina, los servicios y la salud mTLS.
|
||||||
|
|
||||||
|
## Correcciones y versiones usadas
|
||||||
|
|
||||||
|
- La plantilla Azure usa `VpnGw1AZ`, IP de gateway con zonas 1/2/3 y OpenVPN
|
||||||
|
como alternativa a IKEv2. Azure rechazó las opciones anteriores VpnGw1/SSTP.
|
||||||
|
- El disco del controlador tiene caché `None` para las escrituras de AD DS.
|
||||||
|
- El bootstrap del servidor omite la VF de Accelerated Networking que figura
|
||||||
|
activa sin una interfaz IPv4; configura el adaptador que realmente tiene IP.
|
||||||
|
La prueba de regresión cubre ese caso.
|
||||||
|
- Servidor: paquete local `0.5.2-azure.2`, SHA-256
|
||||||
|
`BE29411A1A1C0FE0BB2BB7DB0418EF40881C98A721B42D1F52D54E22487077AC`.
|
||||||
|
- Cliente: paquete local `0.5.2-azure.1`, con la corrección del saludo sin género.
|
||||||
|
Las diferencias posteriores de `.2` corresponden al servidor.
|
||||||
|
|
||||||
|
Estos paquetes de validación no reemplazan el release 0.5.1 publicado en Gitea.
|
||||||
|
La configuración del device tunnel y de su tarea de recuperación se aplicó a
|
||||||
|
esta VM; no está integrada como opción automática en el instalador publicado.
|
||||||
|
|
||||||
|
## Evidencias y acceso administrativo
|
||||||
|
|
||||||
|
Las evidencias están en `artifacts/azure-deployment-20260910/`, excluido de Git:
|
||||||
|
|
||||||
|
- `server-verification.json`: bootstrap del servidor y dcdiag.
|
||||||
|
- `azure-computer-verification.json`: objeto de equipo en el bosque Azure.
|
||||||
|
- `client-enrollment-result.json`: resultado original de unión.
|
||||||
|
- `client-validation-before-final-reboot.json`: validación completa antes del reinicio.
|
||||||
|
- `client-postboot-verification.json`: comprobación posterior del arranque,
|
||||||
|
incluyendo canal seguro, VPN, usuario interactivo y resultados de las tareas.
|
||||||
|
- `windows11-azure-login.jpg`: captura directa del framebuffer de Hyper-V.
|
||||||
|
- `enable-device-tunnel.ps1`: XML y comandos usados para el túnel de esta VM.
|
||||||
|
- `state.json`: inventario y estado de la operación.
|
||||||
|
|
||||||
|
La cuenta administrativa del bosque es `LCI\azureadmin`. Su contraseña generada
|
||||||
|
está protegida con DPAPI en `credentials.clixml`, dentro de ese directorio del
|
||||||
|
host, para el usuario que ejecutó el despliegue. No se guardó en este documento.
|
||||||
|
La contraseña DSRM se generó en la VM Azure y se conserva protegida para SYSTEM
|
||||||
|
en `C:\ProgramData\SGU\Secrets\dsrm-password.clixml`.
|
||||||
|
|
||||||
|
La revisión automática rechazó la limpieza de la cuenta de almacenamiento
|
||||||
|
temporal `sgustagea8e952c02421` y su rol, y después la limpieza de archivos y de
|
||||||
|
la tarea temporal del cliente, sin indicar un motivo específico. No se
|
||||||
|
eliminaron. El PFX del cliente permanece cifrado y bajo una ACL restringida a
|
||||||
|
Administradores/SYSTEM; la tarea instaladora del túnel no tiene disparador
|
||||||
|
recurrente. Esta limpieza queda pendiente.
|
||||||
|
|
||||||
|
OpenVPN y otras configuraciones de VPN no se probaron. Esta validación no
|
||||||
|
extiende el soporte Always On device tunnel a ediciones Windows Pro.
|
||||||
@@ -0,0 +1,242 @@
|
|||||||
|
# Active Directory SGU en Azure: VPN opcional o enrolamiento directo
|
||||||
|
|
||||||
|
La misma plantilla despliega Active Directory en Windows Server 2025 y permite
|
||||||
|
elegir entre Azure VPN Gateway Point-to-Site (P2S) o acceso público directo. El
|
||||||
|
modo directo restringe AD, WinRM, Auth Broker y RustDesk a los CIDR públicos
|
||||||
|
indicados; el cliente configura DoH y la resolución del dominio automáticamente.
|
||||||
|
La lista pública vacía no expone esos servicios.
|
||||||
|
|
||||||
|
La plantilla crea:
|
||||||
|
|
||||||
|
- VNet `10.77.0.0/16`, subnet del DC `10.77.0.0/24` y, si se solicita, `GatewaySubnet`;
|
||||||
|
- Windows Server 2025 con IP privada estática `10.77.0.4` reservada en la NIC;
|
||||||
|
- IP pública Standard para la VM, protegida por NSG;
|
||||||
|
- VPN Gateway opcional `VpnGw1AZ` con IKEv2/OpenVPN y autenticación por certificados;
|
||||||
|
- pool P2S `172.30.0.0/24`, autorizado en los firewalls SGU;
|
||||||
|
- DNS de la NIC del servidor apuntando a `10.77.0.4`;
|
||||||
|
- perfiles locales para todos los usuarios por omisión; Azure Files/FSLogix es
|
||||||
|
una característica opcional que debe habilitarse y aceptarse explícitamente.
|
||||||
|
|
||||||
|
Los prefijos privados deben ser RFC1918 y no deben solaparse con las redes usadas
|
||||||
|
por Hyper-V, el `Default Switch`, Wi-Fi o Ethernet locales. Los prefijos de
|
||||||
|
enrolamiento directo deben ser CIDR IPv4 públicos explícitos.
|
||||||
|
|
||||||
|
## 1. Elegir el modo de conectividad
|
||||||
|
|
||||||
|
Para P2S, crear la autoridad y el certificado de cada cliente:
|
||||||
|
|
||||||
|
En la estación administrativa donde está el repositorio:
|
||||||
|
|
||||||
|
```powershell
|
||||||
|
$p2s = .\scripts\New-SguAzureP2sCertificates.ps1 `
|
||||||
|
-ClientName 'AdminWorkstation'
|
||||||
|
```
|
||||||
|
|
||||||
|
Se pide una contraseña para proteger el PFX. La clave privada de la autoridad
|
||||||
|
raíz permanece no exportable en `Cert:\CurrentUser\My`; Azure recibe solamente
|
||||||
|
el `.cer` público. El PFX es una credencial de acceso a la VNet: se debe copiar
|
||||||
|
únicamente a la VM correspondiente y eliminarse de ubicaciones compartidas
|
||||||
|
después de importarlo.
|
||||||
|
|
||||||
|
Para acceso directo no se necesita certificado P2S. Se necesita conocer el
|
||||||
|
segmento público de salida del laboratorio; por ejemplo, la IP
|
||||||
|
`200.13.89.183` pertenece a `200.13.89.0/24`.
|
||||||
|
|
||||||
|
## 2. Desplegar Azure
|
||||||
|
|
||||||
|
Requisitos: Azure CLI, una sesión iniciada con `az login`, permisos para crear
|
||||||
|
red, gateway, IP pública y VM, y una suscripción seleccionable.
|
||||||
|
|
||||||
|
```powershell
|
||||||
|
$azure = .\scripts\Deploy-SguAzureInfrastructure.ps1 `
|
||||||
|
-SubscriptionId '00000000-0000-0000-0000-000000000000' `
|
||||||
|
-ResourceGroupName 'rg-sgu-lab' `
|
||||||
|
-Location 'centralus' `
|
||||||
|
-AdministratorUsername 'azureadmin' `
|
||||||
|
-P2sRootCertificatePath $p2s.RootCertificatePath
|
||||||
|
```
|
||||||
|
|
||||||
|
Sin VPN y autorizando un laboratorio completo:
|
||||||
|
|
||||||
|
```powershell
|
||||||
|
$azure = .\scripts\Deploy-SguAzureInfrastructure.ps1 `
|
||||||
|
-SubscriptionId '00000000-0000-0000-0000-000000000000' `
|
||||||
|
-ResourceGroupName 'rg-sgu-lab' `
|
||||||
|
-Location 'centralus' `
|
||||||
|
-AdministratorUsername 'azureadmin' `
|
||||||
|
-DeployVpnGateway $false `
|
||||||
|
-PublicEnrollmentSourceAddressPrefixes '200.13.89.0/24' `
|
||||||
|
-AdministratorSourceAddressPrefix '200.13.89.0/24'
|
||||||
|
```
|
||||||
|
|
||||||
|
La contraseña local de la VM se solicita como `SecureString`, se coloca sólo en
|
||||||
|
un archivo temporal con ACL exclusiva para el usuario actual y se elimina al
|
||||||
|
terminar. No aparece en los argumentos de Azure CLI ni queda guardada en el
|
||||||
|
repositorio.
|
||||||
|
|
||||||
|
Por omisión ningún puerto administrativo de la VM se abre desde Internet. Para
|
||||||
|
habilitar temporalmente RDP durante el bootstrap, indique exclusivamente su IP
|
||||||
|
pública actual:
|
||||||
|
|
||||||
|
```powershell
|
||||||
|
-AdministratorSourceAddressPrefix '203.0.113.10/32'
|
||||||
|
```
|
||||||
|
|
||||||
|
No utilice `0.0.0.0/0`. El despliegue de un VPN Gateway suele tardar bastante
|
||||||
|
más que la VM; omitirlo reduce tiempo y costo. El comando espera hasta que Azure
|
||||||
|
entregue un resultado final. User roaming está desactivado por omisión. Sólo se
|
||||||
|
provisiona al indicar juntos `-DeployUserRoaming $true` y
|
||||||
|
`-AcknowledgeUserRoamingRisks`, después de revisar
|
||||||
|
[sus riesgos y recuperación](user-roaming.md).
|
||||||
|
|
||||||
|
## 3. Conectarse al servidor
|
||||||
|
|
||||||
|
Cuando el gateway esté `Succeeded`:
|
||||||
|
|
||||||
|
```powershell
|
||||||
|
$vpn = .\scripts\Get-SguAzureP2sPackage.ps1 `
|
||||||
|
-SubscriptionId '00000000-0000-0000-0000-000000000000' `
|
||||||
|
-ResourceGroupName 'rg-sgu-lab' `
|
||||||
|
-VpnGatewayName $azure.VpnGatewayName
|
||||||
|
|
||||||
|
.\scripts\Install-SguAzureP2sClient.ps1 `
|
||||||
|
-VpnProfilePackagePath $vpn.PackagePath `
|
||||||
|
-ClientCertificatePfxPath $p2s.ClientCertificatePath `
|
||||||
|
-ClientRootCertificatePath $p2s.RootCertificatePath `
|
||||||
|
-Connect
|
||||||
|
```
|
||||||
|
|
||||||
|
Con el túnel conectado, use RDP contra `10.77.0.4` y habilite la redirección de
|
||||||
|
una unidad local para copiar `sgu-server-bootstrap-VERSION.zip` a la VM. La NIC
|
||||||
|
ya apunta a su futura dirección DNS propia, por lo que la resolución pública no
|
||||||
|
está disponible hasta que el bootstrap instale DNS y sus reenviadores. Así no es
|
||||||
|
necesario abrir 3389 en la IP pública. La opción
|
||||||
|
`AdministratorSourceAddressPrefix` queda como ruta de recuperación temporal.
|
||||||
|
|
||||||
|
En modo directo, use RDP contra `$azure.DomainControllerPublicIp` desde un origen
|
||||||
|
incluido en `AdministratorSourceAddressPrefix`. RDP y enrolamiento tienen listas
|
||||||
|
separadas para poder retirar RDP sin interrumpir los clientes.
|
||||||
|
|
||||||
|
## 4. Ejecutar el bootstrap dentro de Windows Server
|
||||||
|
|
||||||
|
Descargue y extraiga `sgu-server-bootstrap-VERSION.zip` dentro de la VM. La IP
|
||||||
|
que recibe el bootstrap es la **privada** de la NIC, nunca la pública:
|
||||||
|
|
||||||
|
```bat
|
||||||
|
Start-SguAzureServerBootstrap.cmd 10.77.0.4 172.30.0.0/24
|
||||||
|
```
|
||||||
|
|
||||||
|
El modo `PlatformManaged` comprueba que Azure ya asignó `10.77.0.4/24`, pero no
|
||||||
|
deshabilita DHCP, no reemplaza la ruta predeterminada y no reinicia el adaptador.
|
||||||
|
El DNS de AD publica únicamente la dirección privada. `168.63.129.16` se usa
|
||||||
|
como reenviador DNS de la plataforma Azure.
|
||||||
|
|
||||||
|
Después del reinicio de promoción, verificar:
|
||||||
|
|
||||||
|
```powershell
|
||||||
|
Get-Content C:\ProgramData\SGU\Bootstrap\Server\bootstrap-complete.json
|
||||||
|
Resolve-DnsName _ldap._tcp.dc._msdcs.lci.lasalle.mx -Type SRV -Server 10.77.0.4
|
||||||
|
```
|
||||||
|
|
||||||
|
El JSON debe indicar `NetworkConfigurationMode = PlatformManaged`, el pool P2S
|
||||||
|
en `TrustedClientNetworks` cuando exista VPN y los CIDR directos en
|
||||||
|
`PublicEnrollmentNetworks` cuando se hayan habilitado.
|
||||||
|
|
||||||
|
Después de terminar la promoción no se necesita ninguna acción de perfiles: las
|
||||||
|
cuentas usarán archivos locales. Si se decide realizar un piloto explícito de
|
||||||
|
Azure Files, publique las políticas ejecutando
|
||||||
|
`Enable-SguAzureUserRoaming.ps1` con `-AcknowledgeUserRoamingRisks`. Esa fase opcional requiere Azure PowerShell y el
|
||||||
|
módulo oficial AzFilesHybrid porque el SID y GUID del bosque todavía no existen
|
||||||
|
durante el despliegue Bicep. Consulte
|
||||||
|
[user roaming por rol en Azure](user-roaming.md).
|
||||||
|
|
||||||
|
## 5. Enrolar cada VM Hyper-V
|
||||||
|
|
||||||
|
En la estación administrativa, emita una credencial distinta por equipo:
|
||||||
|
|
||||||
|
```powershell
|
||||||
|
$w11 = .\scripts\New-SguAzureP2sCertificates.ps1 -ClientName 'Windows11'
|
||||||
|
```
|
||||||
|
|
||||||
|
Copie a la VM Windows 10/11 de Hyper-V:
|
||||||
|
|
||||||
|
- `sgu-windows-client-bootstrap-VERSION.zip` extraído (Windows 10/11 x64);
|
||||||
|
- `$vpn.PackagePath`;
|
||||||
|
- `$w11.ClientCertificatePath`;
|
||||||
|
- `sgu-azure-p2s-root.cer`.
|
||||||
|
|
||||||
|
Desde la carpeta extraída del bootstrap de cliente, instale P2S y enrole:
|
||||||
|
|
||||||
|
```bat
|
||||||
|
Start-SguAzureClientEnrollment.cmd 10.77.0.4 C:\SGU\sgu-azure-vpn-client.zip C:\SGU\sgu-azure-p2s-Windows11.pfx C:\SGU\sgu-azure-p2s-root.cer C:\SGU\FSLogixAppsSetup.exe
|
||||||
|
```
|
||||||
|
|
||||||
|
En una sola ejecución el comando:
|
||||||
|
|
||||||
|
1. importa el certificado de cliente en `LocalMachine\My` sin dejar la
|
||||||
|
contraseña en disco;
|
||||||
|
2. instala un perfil IKEv2 de todos los usuarios llamado `SGU Azure P2S`;
|
||||||
|
3. agrega la ruta `10.77.0.0/16` y una regla NRPT que envía sólo
|
||||||
|
`.lci.lasalle.mx` al DNS `10.77.0.4`;
|
||||||
|
4. conecta P2S con certificado de máquina;
|
||||||
|
5. registra mTLS, instala SGU/RustDesk y une el equipo al dominio;
|
||||||
|
6. reinicia Windows.
|
||||||
|
|
||||||
|
El quinto argumento es opcional. Cuando se proporciona, instala el binario
|
||||||
|
oficial de FSLogix después de validar su firma de Microsoft; puede omitirse si
|
||||||
|
la imagen ya lo contiene. Las GPO activan el contenedor únicamente para AD/DO.
|
||||||
|
|
||||||
|
Para el modo directo, cada Windows 10/11 usa el lanzador normal y la IP pública;
|
||||||
|
no necesita perfil ni certificado VPN:
|
||||||
|
|
||||||
|
```bat
|
||||||
|
Start-SguClientEnrollment.cmd 20.9.81.130
|
||||||
|
```
|
||||||
|
|
||||||
|
El bootstrap pide la cuenta de dominio, prueba todas las interfaces con ruta,
|
||||||
|
descubre el bosque por WinRM, instala el certificado público DoH, configura NRPT
|
||||||
|
y los nombres del DC/broker, registra mTLS y une la máquina. No pide una IP del
|
||||||
|
cliente ni una interfaz.
|
||||||
|
|
||||||
|
Si la red local bloquea IKEv2 (UDP 500/4500), se puede generar un perfil
|
||||||
|
OpenVPN sobre TCP 443 para Azure VPN Client. Ese fallback requiere instalar
|
||||||
|
y configurar el cliente correspondiente; el bootstrap instala el perfil nativo
|
||||||
|
IKEv2. Azure ya no admite SSTP al crear este gateway.
|
||||||
|
|
||||||
|
La prueba real con `Windows11-002` y un bosque en Azure está documentada en
|
||||||
|
[la validación del despliegue del 10 de septiembre de 2026](azure-deployment-validation-2026-09-10.md).
|
||||||
|
Incluye un device tunnel para Enterprise y recuperación de Netlogon cuando el
|
||||||
|
túnel tarda en estar disponible al arrancar. Son configuraciones adicionales
|
||||||
|
aplicadas a esa VM; el instalador publicado crea el perfil manual anterior.
|
||||||
|
|
||||||
|
Windows 10/11 Pro admite unión a AD y VPN nativa, pero Microsoft no licencia el
|
||||||
|
**Always On VPN device tunnel** para Pro. Por ello el perfil se instala para
|
||||||
|
todos los usuarios y se puede seleccionar desde el control de red de la
|
||||||
|
pantalla de inicio de sesión; antes del primer logon de una cuenta de dominio,
|
||||||
|
conecte `SGU Azure P2S` allí. Enterprise/Education pueden recibir posteriormente
|
||||||
|
un device tunnel Always On, pero eso no es requisito del enrolamiento SGU.
|
||||||
|
|
||||||
|
Validación dentro del cliente, con la VPN conectada o usando el acceso directo:
|
||||||
|
|
||||||
|
```powershell
|
||||||
|
Get-VpnConnection -Name 'SGU Azure P2S' -AllUserConnection
|
||||||
|
Get-DnsClientNrptRule | Where-Object DisplayName -like 'SGU Azure P2S*'
|
||||||
|
Test-NetConnection 20.9.81.130 -Port 5985
|
||||||
|
Resolve-DnsName _ldap._tcp.dc._msdcs.lci.lasalle.mx -Type SRV
|
||||||
|
nltest.exe /dsgetdc:lci.lasalle.mx
|
||||||
|
```
|
||||||
|
|
||||||
|
## Alcance de red y referencias
|
||||||
|
|
||||||
|
P2S mantiene los puertos de AD dentro del túnel. El modo directo abre el conjunto
|
||||||
|
necesario para la unión sólo desde `publicEnrollmentSourceAddressPrefixes` y
|
||||||
|
replica la misma lista en Windows Firewall mediante `PublicEnrollmentNetworks`.
|
||||||
|
Prefiera `/32` si la salida es estable; use `/24` únicamente cuando deba admitir
|
||||||
|
todo el segmento. Retire el CIDR cuando termine la prueba si ya no se requiere.
|
||||||
|
|
||||||
|
- [Azure VPN Gateway P2S con certificados](https://learn.microsoft.com/en-us/azure/vpn-gateway/point-to-site-certificate-gateway)
|
||||||
|
- [Cliente P2S nativo de Windows](https://learn.microsoft.com/en-us/azure/vpn-gateway/point-to-site-vpn-client-certificate)
|
||||||
|
- [Instalación de certificados P2S](https://learn.microsoft.com/en-us/azure/vpn-gateway/point-to-site-how-to-vpn-client-install-azure-cert)
|
||||||
|
- [Puertos necesarios para unir un dominio](https://learn.microsoft.com/en-us/troubleshoot/windows-server/identity/active-directory-domain-join-troubleshooting-guidance)
|
||||||
|
- [Requisitos de edición de Windows](https://learn.microsoft.com/en-us/windows/security/licensing-and-edition-requirements)
|
||||||
|
- [Limitación de Always On device tunnel](https://learn.microsoft.com/en-us/azure/vpn-gateway/vpn-gateway-howto-always-on-device-tunnel)
|
||||||
+89
-10
@@ -1,6 +1,6 @@
|
|||||||
# Recuperación desde cero y alta en una sola ejecución
|
# Recuperación desde cero y alta en una sola ejecución
|
||||||
|
|
||||||
Los releases entregan dos ZIP independientes. Cada uno contiene sus binarios,
|
Los releases entregan cuatro ZIP independientes. Cada uno contiene sus binarios,
|
||||||
scripts, instalador offline requerido y un manifiesto SHA-256 interno. No contienen
|
scripts, instalador offline requerido y un manifiesto SHA-256 interno. No contienen
|
||||||
contraseñas, claves privadas ni certificados reutilizables.
|
contraseñas, claves privadas ni certificados reutilizables.
|
||||||
|
|
||||||
@@ -17,6 +17,11 @@ Compatible con Windows Server con Windows PowerShell 5.1. El servidor necesita
|
|||||||
una interfaz privada para el dominio y, para autenticar contra SGU, salida HTTPS
|
una interfaz privada para el dominio y, para autenticar contra SGU, salida HTTPS
|
||||||
por esa u otra interfaz.
|
por esa u otra interfaz.
|
||||||
|
|
||||||
|
Cuando el servidor vive en Azure, no se configura la IP dentro del sistema
|
||||||
|
operativo. La NIC reserva la IP privada y se usa el modo `PlatformManaged`; el
|
||||||
|
procedimiento completo, con VPN Gateway opcional o enrolamiento público directo, está en
|
||||||
|
[azure-vpn-deployment.md](azure-vpn-deployment.md).
|
||||||
|
|
||||||
1. Descargar y extraer `sgu-server-bootstrap-VERSION.zip`.
|
1. Descargar y extraer `sgu-server-bootstrap-VERSION.zip`.
|
||||||
2. Abrir el directorio extraído.
|
2. Abrir el directorio extraído.
|
||||||
3. Ejecutar, indicando la IP fija que tendrá el controlador:
|
3. Ejecutar, indicando la IP fija que tendrá el controlador:
|
||||||
@@ -55,6 +60,8 @@ El proceso crea o configura de forma idempotente:
|
|||||||
- RDP con NLA, WinRM/PowerShell Remoting y reglas administrativas limitadas a
|
- RDP con NLA, WinRM/PowerShell Remoting y reglas administrativas limitadas a
|
||||||
la subred privada indicada, incluso si Windows tarda en reconocer el perfil
|
la subred privada indicada, incluso si Windows tarda en reconocer el perfil
|
||||||
Domain después de la promoción;
|
Domain después de la promoción;
|
||||||
|
- servidor RustDesk OSS autoalojado (`hbbs` y `hbbr`) y su cliente administrado
|
||||||
|
en el propio DC, con puertos de administración limitados a la subred privada;
|
||||||
- pantalla, suspensión e hibernación en Nunca.
|
- pantalla, suspensión e hibernación en Nunca.
|
||||||
|
|
||||||
En un servidor con dos NIC, el bootstrap desactiva el registro DNS de la NIC de
|
En un servidor con dos NIC, el bootstrap desactiva el registro DNS de la NIC de
|
||||||
@@ -63,12 +70,25 @@ privada. También vuelve a iniciar brevemente esa NIC privada si Windows Server
|
|||||||
2025 todavía la clasifica como Public al terminar la promoción. La salida HTTPS
|
2025 todavía la clasifica como Public al terminar la promoción. La salida HTTPS
|
||||||
continúa por la NIC que tenga el gateway predeterminado.
|
continúa por la NIC que tenga el gateway predeterminado.
|
||||||
|
|
||||||
|
Para permitir clientes que llegan directamente desde un segmento público, use
|
||||||
|
`-PublicEnrollmentNetworks` al preparar el servidor. El parámetro valida y
|
||||||
|
normaliza cada CIDR y limita a esos orígenes los puertos de AD, DoH, WinRM,
|
||||||
|
broker y RustDesk:
|
||||||
|
|
||||||
|
```powershell
|
||||||
|
.\Initialize-SguDomainController.ps1 `
|
||||||
|
-ServerIPv4Address 10.77.0.4 `
|
||||||
|
-NetworkConfigurationMode PlatformManaged `
|
||||||
|
-PublicEnrollmentNetworks 200.13.89.0/24
|
||||||
|
```
|
||||||
|
|
||||||
El broker arranca con una lista de clientes vacía. Eso no abre el servicio: mTLS
|
El broker arranca con una lista de clientes vacía. Eso no abre el servicio: mTLS
|
||||||
rechaza todos los certificados hasta que el primer cliente registra el suyo.
|
rechaza todos los certificados hasta que el primer cliente registra el suyo.
|
||||||
Los archivos opcionales colocados en `payload\server-content\Packages` al crear
|
Los archivos opcionales colocados en `payload\server-content\Packages` al crear
|
||||||
el release se copian al recurso compartido. Si allí existe `wallpaper.jpg`,
|
el release se copian al recurso compartido. El paquete siempre incluye
|
||||||
`wallpaper.jpeg`, `wallpaper.png` o `wallpaper.bmp`, la GPO de usuarios lo aplica
|
`welcome-wallpaper`: fondo azul, fuentes Indivisa y generador de respaldo para
|
||||||
automáticamente como fondo con ajuste Fill.
|
reparación o actualización de clientes. La GPO de equipos inicia la copia local
|
||||||
|
del generador en cada sesión; ya no se impone un único fondo estático por usuario.
|
||||||
|
|
||||||
Estado y diagnóstico:
|
Estado y diagnóstico:
|
||||||
|
|
||||||
@@ -88,28 +108,55 @@ Se admiten Pro, Enterprise y Education. Windows Home no puede unirse a Active
|
|||||||
Directory local ni actuar como host RDP; el bootstrap lo detecta antes de cambiar
|
Directory local ni actuar como host RDP; el bootstrap lo detecta antes de cambiar
|
||||||
el equipo y explica que se debe actualizar la edición.
|
el equipo y explica que se debe actualizar la edición.
|
||||||
|
|
||||||
1. Descargar y extraer `sgu-client-bootstrap-VERSION.zip`.
|
1. Descargar y extraer `sgu-windows-client-bootstrap-VERSION.zip`, común para
|
||||||
|
Windows 10 y Windows 11 x64 Pro, Enterprise o Education.
|
||||||
2. Ejecutar con la IP fija actual del controlador de dominio:
|
2. Ejecutar con la IP fija actual del controlador de dominio:
|
||||||
|
|
||||||
```bat
|
```bat
|
||||||
Start-SguClientEnrollment.cmd 192.168.50.10
|
Start-SguClientEnrollment.cmd 192.168.50.10
|
||||||
```
|
```
|
||||||
|
|
||||||
|
También puede hacerse doble clic y escribir la IP del controlador. El cliente
|
||||||
|
conserva sus IP/DHCP y prueba WinRM por las interfaces con rutas disponibles,
|
||||||
|
incluyendo VPN y redes enrutadas. No requiere compartir subred con el servidor.
|
||||||
|
Si una NIC sólo tiene APIPA, necesita DHCP o una IP asignada por el administrador;
|
||||||
|
el bootstrap no inventa direcciones. Si falla, la ventana permanece abierta y
|
||||||
|
el error queda en `C:\ProgramData\SGU\Bootstrap\Client\latest-error.log`.
|
||||||
|
|
||||||
|
El manifiesto usa `Auto` y ambos Windows ejecutan el mismo código. Azure P2S está
|
||||||
|
incluido para ambos; otras VPN ya conectadas usan el lanzador habitual.
|
||||||
|
|
||||||
|
También puede proporcionarse directamente la IP pública del DC. Tras autenticar
|
||||||
|
WinRM, el bootstrap configura DoH y resolución dividida, valida el SRV de AD y
|
||||||
|
continúa sin pedir la IP del cliente. El segmento de salida del laboratorio debe
|
||||||
|
estar en la lista `PublicEnrollmentNetworks` del servidor y en el NSG/firewall
|
||||||
|
perimetral; por ejemplo, `200.13.89.0/24` cubre las salidas `.1` a `.254`.
|
||||||
|
|
||||||
Después de UAC, se solicita interactivamente la credencial autorizada para unir
|
Después de UAC, se solicita interactivamente la credencial autorizada para unir
|
||||||
equipos. La contraseña existe sólo en memoria. El bootstrap:
|
equipos. La contraseña existe sólo en memoria. El bootstrap:
|
||||||
|
|
||||||
1. apunta el DNS del adaptador al IP proporcionado;
|
1. selecciona una interfaz con conectividad comprobada al servidor;
|
||||||
2. abre una sesión WinRM autenticada con el DC y verifica que pertenece al
|
2. abre una sesión WinRM autenticada con el DC, descubre el dominio y configura
|
||||||
dominio esperado;
|
DNS mediante NRPT sólo para ese dominio; cuando la IP es pública, además
|
||||||
|
configura y valida automáticamente DoH, conservando el DNS de Internet;
|
||||||
3. crea en el cliente un certificado mTLS RSA-3072 no exportable y envía sólo su
|
3. crea en el cliente un certificado mTLS RSA-3072 no exportable y envía sólo su
|
||||||
parte pública al broker;
|
parte pública al broker;
|
||||||
4. recupera por esa sesión autenticada el certificado público del broker;
|
4. recupera por esa sesión autenticada el certificado público del broker;
|
||||||
5. instala el runtime .NET 10 offline y el Credential Provider;
|
5. instala el runtime .NET 10 offline y el Credential Provider;
|
||||||
6. valida binarios, registro COM, certificados y salud del broker;
|
6. valida binarios, registro COM, certificados y salud del broker;
|
||||||
7. instala el guardián de reparación al arranque;
|
7. instala el guardián de reparación al arranque;
|
||||||
8. sólo entonces ejecuta `Add-Computer` dentro de `OU=Laboratorio` y reinicia;
|
8. sólo entonces ejecuta `Add-Computer` en `OU=Laboratorio` si existe, o en el
|
||||||
|
contenedor de equipos predeterminado del dominio, y reinicia;
|
||||||
9. al arrancar, activa RDP/NLA, WinRM y las reglas Domain, y vuelve a validar el
|
9. al arrancar, activa RDP/NLA, WinRM y las reglas Domain, y vuelve a validar el
|
||||||
enrolamiento.
|
enrolamiento.
|
||||||
|
10. instala RustDesk desde el MSI oficial comprobado, lo apunta al servidor
|
||||||
|
`rustdesk.lci.lasalle.mx` y registra el ID del dispositivo en el inventario
|
||||||
|
protegido del DC.
|
||||||
|
|
||||||
|
Cuando la IP del DC es pública, el paso 2 crea o reutiliza DoH en el servidor,
|
||||||
|
recupera su certificado público, configura el cliente y valida el registro SRV
|
||||||
|
antes de continuar. El mismo doble clic funciona en LAN, una VPN ya conectada o
|
||||||
|
Internet directo; el operador sólo proporciona IP del DC y credenciales.
|
||||||
|
|
||||||
Para elegir adaptador o nombre del equipo explícitamente:
|
Para elegir adaptador o nombre del equipo explícitamente:
|
||||||
|
|
||||||
@@ -117,6 +164,8 @@ Para elegir adaptador o nombre del equipo explícitamente:
|
|||||||
powershell.exe -NoProfile -ExecutionPolicy Bypass `
|
powershell.exe -NoProfile -ExecutionPolicy Bypass `
|
||||||
-File .\Invoke-SguClientBootstrap.ps1 `
|
-File .\Invoke-SguClientBootstrap.ps1 `
|
||||||
-DomainControllerIPv4Address 192.168.50.10 `
|
-DomainControllerIPv4Address 192.168.50.10 `
|
||||||
|
-ClientIPv4Address 192.168.50.11 `
|
||||||
|
-ClientPrefixLength 24 `
|
||||||
-NetworkInterfaceAlias 'Ethernet' `
|
-NetworkInterfaceAlias 'Ethernet' `
|
||||||
-NewComputerName 'LCI-101'
|
-NewComputerName 'LCI-101'
|
||||||
```
|
```
|
||||||
@@ -125,12 +174,42 @@ La IP del argumento es siempre la IP fija **actual del servidor**, no una IP que
|
|||||||
queda compilada en el Credential Provider. El proveedor usa después el nombre
|
queda compilada en el Credential Provider. El proveedor usa después el nombre
|
||||||
DNS `sgu-auth.lci.lasalle.mx`, que el bootstrap del servidor actualiza.
|
DNS `sgu-auth.lci.lasalle.mx`, que el bootstrap del servidor actualiza.
|
||||||
|
|
||||||
|
La administración gráfica autoalojada se documenta en
|
||||||
|
[rustdesk-operations.md](rustdesk-operations.md). Durante la primera instalación
|
||||||
|
el servidor y los clientes necesitan salida HTTPS para obtener los instaladores
|
||||||
|
RustDesk verificados; el tráfico de soporte posterior permanece dentro de la
|
||||||
|
subred privada del laboratorio.
|
||||||
|
|
||||||
Un administrador del dominio todavía puede ignorar deliberadamente este flujo y
|
Un administrador del dominio todavía puede ignorar deliberadamente este flujo y
|
||||||
ejecutar `Add-Computer` a mano; ninguna GPO puede impedir a un administrador del
|
ejecutar `Add-Computer` a mano; ninguna GPO puede impedir a un administrador del
|
||||||
bosque modificar el dominio. Para la operación soportada, el script aplica una
|
bosque modificar el dominio. Para la operación soportada, el script aplica una
|
||||||
transacción proveedor-primero y se niega a unir un equipo que no haya pasado las
|
transacción proveedor-primero y se niega a unir un equipo que no haya pasado las
|
||||||
validaciones.
|
validaciones.
|
||||||
|
|
||||||
|
## Cliente Linux nuevo
|
||||||
|
|
||||||
|
El ZIP `sgu-linux-client-bootstrap-VERSION.zip` usa el mecanismo nativo de
|
||||||
|
Linux: `realmd`, Kerberos, SSSD, NSS y PAM. No distribuye ni instala el
|
||||||
|
Credential Provider de Windows.
|
||||||
|
|
||||||
|
En una VM con Internet por `Default Switch` y una NIC privada conectada a
|
||||||
|
`Laboratorio AD`, ejecutar como administrador:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
sudo bash ./Enroll-SguLinuxDomainClient.sh \
|
||||||
|
--domain-controller 192.168.50.10 \
|
||||||
|
--domain-interface eth0 \
|
||||||
|
--domain-address 192.168.50.12/24 \
|
||||||
|
--enable-ssh
|
||||||
|
```
|
||||||
|
|
||||||
|
La contraseña de la cuenta autorizada para la unión se solicita de forma
|
||||||
|
interactiva por `realmd`; no se incluye en la línea de comandos. El script
|
||||||
|
configura DNS de AD en la NIC privada, preserva la ruta de Internet, crea la
|
||||||
|
cuenta de equipo en `OU=Laboratorio`, habilita creación de directorio personal
|
||||||
|
mediante PAM y valida la cuenta de equipo con `adcli testjoin`. La documentación
|
||||||
|
de operación completa está en [linux-client-enrollment.md](linux-client-enrollment.md).
|
||||||
|
|
||||||
## Crear y publicar un release
|
## Crear y publicar un release
|
||||||
|
|
||||||
Desde el repositorio y con el SDK fijado en `global.json`:
|
Desde el repositorio y con el SDK fijado en `global.json`:
|
||||||
@@ -150,4 +229,4 @@ la línea de comandos. Para empaquetar recursos institucionales adicionales:
|
|||||||
-ServerContentPath C:\Preparacion\Packages
|
-ServerContentPath C:\Preparacion\Packages
|
||||||
```
|
```
|
||||||
|
|
||||||
`SHA256SUMS-VERSION.txt` permite comprobar ambos ZIP antes de usarlos.
|
`SHA256SUMS-VERSION.txt` permite comprobar los cuatro ZIP antes de usarlos.
|
||||||
@@ -51,10 +51,18 @@ Eso es comportamiento esperado, no una caída del servicio.
|
|||||||
`/psulsa/`. El enriquecimiento usa el límite total independiente
|
`/psulsa/`. El enriquecimiento usa el límite total independiente
|
||||||
`ProfileTimeoutSeconds` —**90 segundos** en la configuración del laboratorio—
|
`ProfileTimeoutSeconds` —**90 segundos** en la configuración del laboratorio—
|
||||||
y conserva los campos que alcance a obtener si una página de personal se
|
y conserva los campos que alcance a obtener si una página de personal se
|
||||||
retrasa, no existe o cambia sus IDs. Esto incluye los módulos opcionales de
|
retrasa, no existe o cambia sus IDs. Para docentes esto incluye consulta de
|
||||||
nombre y ubicación para docentes. El Credential Provider mantiene su propio límite de **90
|
nómina —clave, nombre, correo, tipo y puesto— más los módulos opcionales de
|
||||||
|
nombre y ubicación. El Credential Provider mantiene su propio límite de **90
|
||||||
segundos**: si SGU excede ese presupuesto, Windows continúa por el fallback
|
segundos**: si SGU excede ese presupuesto, Windows continúa por el fallback
|
||||||
normal de AD o credenciales de dominio en caché.
|
normal de AD o credenciales de dominio en caché.
|
||||||
|
Cuando el HTML confirma la clave institucional, el broker solicita la foto
|
||||||
|
del endpoint de SGU con la misma sesión autenticada: `tp=1` para alumnos y
|
||||||
|
`tp=2` para administrativos/docentes. Solo acepta JPEG de hasta 100 KiB, con
|
||||||
|
un límite adicional de 3 segundos. Un error, HTML de login, timeout o foto
|
||||||
|
inválida conserva la foto anterior y no impide el inicio de sesión. La
|
||||||
|
escritura de `thumbnailPhoto` en AD también es independiente de los demás
|
||||||
|
metadatos y de la sincronización de contraseña.
|
||||||
- El instalador configura recuperación del servicio con reinicios a los 5, 15
|
- El instalador configura recuperación del servicio con reinicios a los 5, 15
|
||||||
y 60 segundos y reinicia el contador de fallos después de 24 horas.
|
y 60 segundos y reinicia el contador de fallos después de 24 horas.
|
||||||
- Si el broker o SGU no está disponible, el Credential Provider entrega la
|
- Si el broker o SGU no está disponible, el Credential Provider entrega la
|
||||||
|
|||||||
@@ -0,0 +1,423 @@
|
|||||||
|
# Centro de Experiencia Digital network
|
||||||
|
|
||||||
|
The managed Wi-Fi network is **Centro de Experiencia Digital**, on the ASUS
|
||||||
|
GT-AX11000 Pro. It replaces Aula Flexible and Sala de Desarrollo for the CED PCs.
|
||||||
|
Configuration is scoped to:
|
||||||
|
|
||||||
|
```text
|
||||||
|
OU=Centro de Experiencia Digital,OU=Laboratorio,DC=lci,DC=lasalle,DC=mx
|
||||||
|
```
|
||||||
|
|
||||||
|
The current Wi-Fi policy targets member workstations with names beginning
|
||||||
|
`AF-`, `SD-`, or `SI-` in this OU: 47 enabled domain computers on October 14,
|
||||||
|
2026. Its WMI filter excludes servers and `APPS-` Ethernet workstations.
|
||||||
|
LCI-77 uses a local profile and remains outside the domain.
|
||||||
|
|
||||||
|
## Router configuration
|
||||||
|
|
||||||
|
| Network | Result |
|
||||||
|
| --- | --- |
|
||||||
|
| Centro de Experiencia Digital | VLAN 53, 192.168.54.0/24, gateway 192.168.54.1, WPA2/WPA3-Personal, AES, 2.4/5 GHz |
|
||||||
|
| Sala de Desarrollo | Disabled, configuration retained for recovery |
|
||||||
|
| Sala Inmersiva | Existing SSID, key, VLAN 54 and 192.168.55.0/24 retained |
|
||||||
|
| Invitados CED | Retained |
|
||||||
|
| Esports CED | Retained with its pre-existing enable/disable state |
|
||||||
|
| NewMatrix | Existing main network retained |
|
||||||
|
|
||||||
|
The previous Aula Flexible shared key is retained privately. The old 20 Mbps
|
||||||
|
download / 5 Mbps upload cap is removed from the CED network. DHCP provides the
|
||||||
|
domain DNS server at 192.168.54.211. AP isolation is off for management between
|
||||||
|
the CED PCs. Existing separation of the other guest networks is retained.
|
||||||
|
|
||||||
|
Router configuration changes restart shared radios and can interrupt all Wi-Fi
|
||||||
|
connections briefly, including unchanged SSIDs. SGU-DC02 itself is connected by
|
||||||
|
Wi-Fi, despite LCI-77 having Ethernet. Prepare a server reconnection task before
|
||||||
|
applying router changes. Radio/DFS readiness can take several minutes; do not
|
||||||
|
repeat Apply while waiting for recovery.
|
||||||
|
|
||||||
|
## Group Policy and future computers
|
||||||
|
|
||||||
|
`Set-SguCedWifiPolicy.ps1` publishes a native computer WLAN policy in
|
||||||
|
**CED - Wi-Fi de salas**. The GPO is enforced on the CED OU, disables user
|
||||||
|
settings, and filters for AF, SD, and SI member workstations. The native
|
||||||
|
**Centro de Experiencia Digital** profile remains a read-only Group Policy
|
||||||
|
profile. An additional **CED - Equipo** all-user profile caches the same network
|
||||||
|
credentials in Windows' protected machine profile store. This cache is available
|
||||||
|
before any user signs in and survives sign-out.
|
||||||
|
|
||||||
|
The Personal shared key is stored in the native AD WLAN policy object. Its ACL
|
||||||
|
permits the CED computer reader group and direct CED computer SIDs, plus the
|
||||||
|
administrative/system identities needed to maintain it. The key is not stored
|
||||||
|
in SYSVOL scripts or in this repository. Exported profiles containing the key
|
||||||
|
must remain in an administrator-only private directory.
|
||||||
|
|
||||||
|
On some Windows clients the native CSE left the Personal key unprotected;
|
||||||
|
others did not have the CED profile at all. `Repair-SguCedWifi.ps1` uses the
|
||||||
|
documented Native Wi-Fi API to repair local key protection and prepare the cached
|
||||||
|
all-user profile. Initial provisioning can read the existing restricted AD WLAN
|
||||||
|
object using the computer account; no administrator password is stored on the
|
||||||
|
client. The cached profile subsequently works without an AD connection.
|
||||||
|
The helper combines native interface state with WLAN service events when Windows
|
||||||
|
denies querying the current SSID. It does not change location privacy consent.
|
||||||
|
|
||||||
|
The computer startup policy installs **CED WiFi policy connection**, a SYSTEM
|
||||||
|
task triggered by boot, computer policy completion, sign-out, and successful
|
||||||
|
Wi-Fi connection events. It replaces the previous 15-minute reconnection loop.
|
||||||
|
WLAN AutoConfig performs normal automatic connections. The repair helper exits
|
||||||
|
after reconciling the cached profile; there is no client polling interval.
|
||||||
|
Its code directory permits writes only by SYSTEM and local administrators.
|
||||||
|
**CED WiFi OU readers refresh** on SGU-DC02 still updates the reader group and
|
||||||
|
direct policy ACLs every 15 minutes, restricted to AF, SD, and SI computers.
|
||||||
|
|
||||||
|
New domain computers in the OU receive policy automatically after reader refresh
|
||||||
|
and normal Group Policy processing. They still need an initial path to a domain
|
||||||
|
controller, such as Ethernet or an existing Wi-Fi profile, to join the domain
|
||||||
|
and receive their first policy. Existing disconnected computers likewise need
|
||||||
|
one initial connection to fetch the correction. The cached Personal profile
|
||||||
|
does not require user credentials, RADIUS, or a certificate authority. Domain
|
||||||
|
DNS and management services still depend on their servers being available.
|
||||||
|
|
||||||
|
CED profiles use automatic connection with automatic switching disabled.
|
||||||
|
Other saved all-user Wi-Fi profiles are retained and changed to manual
|
||||||
|
connection. The sign-in network selector stays available and the policy allows
|
||||||
|
creating an all-user emergency profile. A manually selected alternate connection
|
||||||
|
is preserved by routine repair; explicit `-PreferCedNow` requests migration and
|
||||||
|
attempts to restore the previous profile if CED does not connect. Emergency
|
||||||
|
connectivity does not itself provide a route to the domain controller.
|
||||||
|
|
||||||
|
`Set-SguCedDnsPolicy.ps1` creates **CED - DNS de dominio**, linked only to the
|
||||||
|
same OU. Its NRPT rule directs the internal domain namespace to 192.168.54.211.
|
||||||
|
This avoids public Ethernet DNS competing with Wi-Fi domain DNS on multihomed
|
||||||
|
PCs. Public namespaces retain their normal resolution settings.
|
||||||
|
On CED, the managed Wi-Fi adapter uses 192.168.54.211 and 192.168.54.1 as its
|
||||||
|
resolvers. On a manually chosen alternate Wi-Fi, the helper restores DHCP DNS
|
||||||
|
instead of leaving CED's resolver addresses pinned. Internal names continue
|
||||||
|
to use the NRPT domain rule; public fallback does not provide domain services.
|
||||||
|
The seven pre-existing SI DNS records originally created for workgroup hosts
|
||||||
|
also permit their respective domain computer accounts to update their own
|
||||||
|
records securely after a subnet change. Secure-only zone updates are preserved.
|
||||||
|
|
||||||
|
## Windows Admin Center
|
||||||
|
|
||||||
|
`Set-SguCedWacCertificate.ps1` provisions a non-exportable RSA 3072-bit server
|
||||||
|
certificate for `sgu-dc02.lci.lasalle.mx` and `sgu-dc02`, binds it to the WAC
|
||||||
|
frontend, and distributes its public trust through **CED - Confianza de
|
||||||
|
administracion** in the CED OU. It backs up the previous WAC settings before
|
||||||
|
changing the binding. It does not install a certificate authority.
|
||||||
|
|
||||||
|
LCI-77 trusts the public certificate in the current user's Root store. This does
|
||||||
|
not join it to the domain. Keep the WAC private key on SGU-DC02. Renew the
|
||||||
|
certificate and update the trust policy before expiry.
|
||||||
|
|
||||||
|
`Sync-SguWacDomainConnections.ps1 -ComputerOuDn <CED OU>` limits inventory additions
|
||||||
|
to this OU. Verification queries actual OS instances through WAC; having a saved
|
||||||
|
connection alone is not proof of management connectivity. Existing unrelated WAC
|
||||||
|
inventory entries are not deleted. Authentication and certificate validation
|
||||||
|
remain enabled.
|
||||||
|
|
||||||
|
## Configuration Manager
|
||||||
|
|
||||||
|
The existing collection **LCI00014** is named **Centro de Experiencia Digital**.
|
||||||
|
Its query uses the exact CED canonical OU. Periodic and incremental evaluation
|
||||||
|
are enabled, preserving the collection ID and existing client-setting deployments.
|
||||||
|
AD system discovery remains enabled, including its existing incremental polling.
|
||||||
|
`Set-SguCedConfigMgrCollection.ps1` reproduces this configuration.
|
||||||
|
|
||||||
|
`Set-SguCedClientSource.ps1` prepares the complete Microsoft-signed client media
|
||||||
|
in `C:\ProgramData\LCI-Admin\ClientSource`, shared as `CEDClient$` with encrypted
|
||||||
|
SMB. CED computers have read access, including direct computer permissions for
|
||||||
|
machines whose existing Kerberos tickets predate reader-group membership. The
|
||||||
|
administrative `SMS_LCI` share is not opened to client computers.
|
||||||
|
|
||||||
|
Use `/source` alone for this source, plus the installation properties
|
||||||
|
`SMSSITECODE=LCI SMSMP=sgu-dc02.lci.lasalle.mx`. Adding `/mp` gives management-point
|
||||||
|
and distribution-point discovery priority and previously left these installs
|
||||||
|
waiting. The native startup policy also installs a SYSTEM enrollment task for
|
||||||
|
future CED computers. It validates current OU membership and the Microsoft
|
||||||
|
signature, skips an existing client or running setup, and retries every 30 minutes.
|
||||||
|
|
||||||
|
For an existing computer migration, prepare DNS/policy and migrate Wi-Fi first.
|
||||||
|
Verify the new connection before starting the client installer. Changing Wi-Fi
|
||||||
|
during source download can fail the installation and require a retry.
|
||||||
|
|
||||||
|
```powershell
|
||||||
|
# Run on SGU-DC02 with authorized administrative credentials supplied in memory.
|
||||||
|
.\scripts\Set-SguCedClientSource.ps1
|
||||||
|
.\scripts\Set-SguCedWifiPolicy.ps1 -ProfilePath <private clear-key WLAN XML>
|
||||||
|
.\scripts\Sync-SguCedWifiReaders.ps1 -InstallRefreshTask
|
||||||
|
.\scripts\Set-SguCedDnsPolicy.ps1
|
||||||
|
.\scripts\Set-SguCedWacCertificate.ps1
|
||||||
|
.\scripts\Set-SguCedConfigMgrCollection.ps1
|
||||||
|
.\scripts\Set-SguCedNotificationFirewall.ps1
|
||||||
|
|
||||||
|
$credential = Get-Credential
|
||||||
|
.\scripts\Invoke-SguCedPreparation.ps1 -InventoryPath <private inventory JSON> -Credential $credential -MigrateWifi
|
||||||
|
.\scripts\Test-SguCedManagedNodes.ps1 -Credential $credential
|
||||||
|
.\scripts\Invoke-SguCedPreparation.ps1 -InventoryPath <private inventory JSON> -Credential $credential -InstallClient
|
||||||
|
```
|
||||||
|
|
||||||
|
Inventory JSON is an array of `Name`, `IP`, and `WinRM` properties. Preparation
|
||||||
|
validates the AD scope and actual remote hostname, domain, and secure channel
|
||||||
|
before changing anything. It prefers current DNS over a stale DHCP inventory
|
||||||
|
address. Existing DNS settings are backed up on each client.
|
||||||
|
|
||||||
|
## Rollout validation — October 1, 2026
|
||||||
|
|
||||||
|
After the final router radio restart, the live client validation returned:
|
||||||
|
|
||||||
|
| Check | Result |
|
||||||
|
| --- | --- |
|
||||||
|
| CED computers in scope | 39 |
|
||||||
|
| Reachable over authenticated WinRM | 39 |
|
||||||
|
| Live CED SSID and matching successful policy profile event | 39 |
|
||||||
|
| CcmExec running and site LCI assigned | 39 |
|
||||||
|
| WAC public certificate trusted in the machine Root store | 39 |
|
||||||
|
| WAC returned actual OS instances over validated HTTPS | 39 |
|
||||||
|
|
||||||
|
ConfigMgr also reported 39 CED resources with `Client=1` and the expected OU
|
||||||
|
attribute. SD-06 was initially unavailable; it was prepared, migrated, installed,
|
||||||
|
and validated after being made available. The client installer logs on SD-06,
|
||||||
|
SD-09, and the SD-27 pilot returned exit code 0. LCI-77 successfully reconnected
|
||||||
|
with its local profile while remaining outside the domain. The router UI showed
|
||||||
|
the new SSID with WPA2/WPA3-Personal and Sala de Desarrollo disabled.
|
||||||
|
|
||||||
|
Private per-machine validation JSON and the router screenshot are stored outside
|
||||||
|
Git in the administrator's private CED network directory. No passwords, shared
|
||||||
|
keys, private certificates, or original clear-key WLAN exports are committed.
|
||||||
|
|
||||||
|
## Verification and recovery
|
||||||
|
|
||||||
|
`Test-SguCedManagedNodes.ps1` checks live SSID, the successful profile event,
|
||||||
|
reachable WinRM, CcmExec, assigned site, and WAC root trust. Also verify the WAC
|
||||||
|
OS endpoint, ConfigMgr server-side client registration, and collection membership.
|
||||||
|
The validation script also reads `CNIsOnline` from the local site provider and
|
||||||
|
returns it as `NotificationOnline`. A null value means provider data is unavailable;
|
||||||
|
it must not be interpreted as an offline client.
|
||||||
|
An installation wizard success screen or a scheduled installation request does
|
||||||
|
not establish that installation completed.
|
||||||
|
|
||||||
|
### Configuration Manager gray X icons
|
||||||
|
|
||||||
|
The green check and gray X indicate the client notification connection. They are
|
||||||
|
separate from `Client=Yes`, recent client activity, and client health. On October 1,
|
||||||
|
AF-02 through AF-06 and AF-10 remained reachable with CcmExec running, but their
|
||||||
|
notification logs repeatedly reported `Failed to find a access point ... 8000000a`.
|
||||||
|
Restarting CcmExec restored management-point discovery. The server was listening
|
||||||
|
on TCP 10123, but connections timed out until the missing inbound firewall rule
|
||||||
|
was added. `Set-SguCedNotificationFirewall.ps1` reproduces that rule for only
|
||||||
|
SGU-DC02's CED address, the Domain firewall profile, and the notification host
|
||||||
|
process. It initially allowed source subnet `192.168.54.0/24`; it now also allows
|
||||||
|
`192.168.55.0/24` for the requested Sala Inmersiva management access described below.
|
||||||
|
|
||||||
|
After correcting the port, restart CcmExec only on affected clients when needed,
|
||||||
|
then check their notification keep-alive logs and server-side `CNIsOnline`.
|
||||||
|
Allow time for status reports and refresh the console. Do not reinstall the
|
||||||
|
client solely because its notification icon is gray.
|
||||||
|
|
||||||
|
The follow-up validation reported all 39 CED devices reachable and
|
||||||
|
`NotificationOnline=True`, including all six affected AF clients. The server log
|
||||||
|
confirmed 39 online notification sessions (6 TCP and 33 HTTP). No operating-system
|
||||||
|
restart or client reinstallation was needed.
|
||||||
|
|
||||||
|
### CED and Sala Inmersiva inter-network access
|
||||||
|
|
||||||
|
At the administrator's subsequent request on October 1, the router's Guest
|
||||||
|
Network Pro **Access Intranet** settings were changed to allow the CED (VLAN 53,
|
||||||
|
`192.168.54.0/24`) and Sala Inmersiva (VLAN 54, `192.168.55.0/24`) networks to
|
||||||
|
communicate. From the CED profile, only Sala Inmersiva was newly selected. After
|
||||||
|
applying and reloading the router, the Sala Inmersiva profile also showed CED
|
||||||
|
selected: the setting is reciprocal. Its pre-existing Main Network selection was
|
||||||
|
preserved. Esports CED and Invitados CED were not selected for this new connection.
|
||||||
|
No SSID, password, subnet, or Wi-Fi GPO scope was changed. Applying the router
|
||||||
|
configuration briefly restarted wireless connections; LCI-77 reconnected using
|
||||||
|
its existing CED profile.
|
||||||
|
|
||||||
|
Authenticated WinRM from SGU-DC02 reached SD-17 (`192.168.55.19`) and SD-21
|
||||||
|
(`192.168.55.20`), with both reporting live SSID **Sala Inmersiva**. Both clients
|
||||||
|
could reach the management point's HTTP endpoint and, after extending the scoped
|
||||||
|
notification firewall rule, TCP 10123. A separate client-to-client test confirmed
|
||||||
|
TCP 2701 from AF-02 on CED to SD-17 on Sala Inmersiva and in the reverse direction.
|
||||||
|
AF-02 could also reach SD-17's WinRM port. These are service reachability checks,
|
||||||
|
not proof that every Windows service accepts connections from every peer.
|
||||||
|
|
||||||
|
Use DNS names or IP addresses in management tools across these subnets. Router
|
||||||
|
routing alone does not make every computer appear automatically in Windows
|
||||||
|
Explorer's Network view. Windows firewall rules, authentication, and enabled
|
||||||
|
management services still apply. New Windows clients still need discovery and
|
||||||
|
client enrollment; Wi-Fi profile deployment remains limited to the CED OU.
|
||||||
|
|
||||||
|
#### Workgroup RDP validation: SI-04
|
||||||
|
|
||||||
|
The initial AF/SD management tests did not establish short-name resolution for
|
||||||
|
workgroup computers in Sala Inmersiva. SI-04 was subsequently checked before
|
||||||
|
domain enrollment. It had no AD computer object or domain DNS record, and the
|
||||||
|
router answered its short name only when explicitly queried at `192.168.55.1`.
|
||||||
|
On October 1 its DHCP address was `192.168.55.138`.
|
||||||
|
|
||||||
|
From LCI-77 with live SSID **Centro de Experiencia Digital**, TCP 3389 to that
|
||||||
|
address succeeded. An actual RDP connection negotiation returned a 19-byte reply
|
||||||
|
with negotiation response type 2 and selected protocol 2 (HYBRID/NLA). This
|
||||||
|
validates the RDP endpoint across the VLANs, not an authenticated desktop session.
|
||||||
|
This initial test did not enroll SI-04 or create a domain DNS record. Before
|
||||||
|
enrollment, an authenticated RDP login still requires an authorized local SI-04
|
||||||
|
account.
|
||||||
|
|
||||||
|
#### Workgroup names available from CED
|
||||||
|
|
||||||
|
The subsequent DNS repair publishes A records in the existing secure AD DNS
|
||||||
|
zone `lci.lasalle.mx`, without creating AD computer objects. The router's Sala
|
||||||
|
Inmersiva client list identified six additional Windows workgroup names:
|
||||||
|
`SI-02`, `SI-04`, `SI-05`, `SI-06`, `SI-07`, and `SI-08`. Each address was verified
|
||||||
|
with a direct DNS query to `192.168.55.1` before publication. SI-04 currently
|
||||||
|
resolves to `192.168.55.138`.
|
||||||
|
|
||||||
|
SI-03 was subsequently added after a direct router DNS query returned
|
||||||
|
`192.168.55.120`. Its A record and manifest entry bring the approved list to
|
||||||
|
seven computers, SI-02 through SI-08. The Windows application resolver on LCI-77
|
||||||
|
successfully resolved **SI-03** while connected to CED. SI-01 did not have a router
|
||||||
|
DNS answer during this follow-up and was not assigned a guessed address.
|
||||||
|
|
||||||
|
On SGU-DC02, task **LCI - Sala Inmersiva workgroup DNS** runs
|
||||||
|
`scripts/Sync-SguSalaWorkgroupDns.ps1` as SYSTEM every five minutes, using the
|
||||||
|
protected folder `C:\ProgramData\LCI-Admin\Sala-DNS`. No credentials are stored.
|
||||||
|
Its `manifest.json` contains the approved names and their last published
|
||||||
|
addresses. Only router answers in `192.168.55.0/24` are accepted. The sync refuses
|
||||||
|
to overwrite records changed by another administrator and stops managing a name
|
||||||
|
once it has an AD computer object. New names require explicit approval and an
|
||||||
|
entry in this manifest; arbitrary guest/IoT clients are not imported.
|
||||||
|
|
||||||
|
Records have a five-minute TTL. A failed router query preserves the last record
|
||||||
|
and reports an error in `last-result.json` and the task result; the TTL does not
|
||||||
|
expire the server record. Review these errors if an address becomes stale.
|
||||||
|
The first two SYSTEM runs completed successfully with all six records current.
|
||||||
|
The zone continues to allow secure dynamic updates only.
|
||||||
|
|
||||||
|
Domain clients use their domain suffix and existing **CED - DNS de dominio** GPO.
|
||||||
|
The workgroup administrator PC LCI-77 additionally needed the Wi-Fi connection
|
||||||
|
suffix `lci.lasalle.mx` and an NRPT rule for that namespace pointing to
|
||||||
|
`192.168.54.211`; `scripts/Set-SguCedAdminDns.ps1` reproduces this local setup.
|
||||||
|
The prior suffix is saved in `LCI77-Sala-DNS-before.json` in the protected private
|
||||||
|
folder. The rule applies only to this DNS namespace; existing Tailscale rules
|
||||||
|
remain intact. A later SSID switch showed that Windows cleared the connection
|
||||||
|
suffix on Sala Inmersiva, so an adapter suffix alone was insufficient. The script
|
||||||
|
now sets a persistent global DNS search list with `lci.lasalle.mx` first and
|
||||||
|
preserves existing global and interface suffixes, including Tailscale's suffix.
|
||||||
|
The original global list is saved separately in `LCI77-DnsSearchList-before.json`.
|
||||||
|
|
||||||
|
Validation used Windows' application resolver (`System.Net.Dns.GetHostAddresses`),
|
||||||
|
not just an explicit DNS-server query. All six short names resolved on LCI-77
|
||||||
|
while its live SSID was **Centro de Experiencia Digital**. AF-02, at
|
||||||
|
`192.168.54.130`, also resolved SI-04 correctly. A TCP connection opened using
|
||||||
|
the name **SI-04** from LCI-77 reached port 3389 and received a successful RDP
|
||||||
|
HYBRID/NLA negotiation response. This verifies name resolution and the RDP
|
||||||
|
endpoint across networks; it does not assert an authenticated desktop session.
|
||||||
|
|
||||||
|
To undo this DNS repair, disable the sync task first. Remove only manifest-owned
|
||||||
|
A records that still match their last published IP and have no AD computer object.
|
||||||
|
On LCI-77, restore the saved global search list and Wi-Fi suffix, and remove only
|
||||||
|
the NRPT rule with the
|
||||||
|
comment `CED domain DNS for local administrator Wi-Fi`. Keep the domain GPO and
|
||||||
|
unrelated DNS rules. These DNS changes require no router apply or radio restart.
|
||||||
|
|
||||||
|
#### Sala Inmersiva to SGU-DC02 name resolution
|
||||||
|
|
||||||
|
The reverse direction needed an additional change: Sala's original router DNS
|
||||||
|
at `192.168.55.1` returned NXDOMAIN for both `SGU-DC02` and its FQDN. Guest Network
|
||||||
|
Pro now assigns **192.168.54.211** as Sala Inmersiva's DHCP DNS server. This change
|
||||||
|
keeps its SSID, authentication, VLAN 54, and gateway `192.168.55.1`. Applying it
|
||||||
|
briefly restarted the radios; a temporary reconnection task protected SGU-DC02
|
||||||
|
and was removed after verifying server access. CED, Invitados CED, and Esports CED
|
||||||
|
were visible again after a fresh wireless scan. LCI-77 returned to CED after testing.
|
||||||
|
|
||||||
|
Workgroup clients with no domain suffix also need an answer to the bare server
|
||||||
|
name. `scripts/Set-SguCedShortNameDns.ps1` creates the narrowly scoped AD-integrated
|
||||||
|
DNS zone `sgu-dc02`, with an apex A record for `192.168.54.211` and dynamic updates
|
||||||
|
disabled. The regular `sgu-dc02.lci.lasalle.mx` record is unchanged. No root zone,
|
||||||
|
domain membership, hosts-file entry, or WINS service is created.
|
||||||
|
|
||||||
|
To preserve bare SI names for clients receiving the new DNS setting,
|
||||||
|
`scripts/Sync-SguSalaShortNames.ps1` similarly maintains the seven approved SI
|
||||||
|
labels. The existing five-minute Sala DNS task invokes this helper after updating
|
||||||
|
the regular domain records. The helper mirrors each FQDN A record into its
|
||||||
|
corresponding bare-name zone and refuses to overwrite records that differ from
|
||||||
|
its protected `short-names-owned.json`. It logs to `short-names-result.json`.
|
||||||
|
All eight bare-name answers were verified, and the SYSTEM task returned exit 0.
|
||||||
|
GlobalNames support remains disabled as before this change.
|
||||||
|
|
||||||
|
LCI-77 temporarily connected to live SSID **Sala Inmersiva**, received
|
||||||
|
`192.168.55.201` with DNS `192.168.54.211`, and successfully queried the bare
|
||||||
|
`SGU-DC02`, its FQDN, SI-03's FQDN, and a public Internet name. This verifies the
|
||||||
|
new DHCP setting and DNS access across the VLANs. SI-03 itself was not remotely
|
||||||
|
reconfigured: its WinRM ports were unavailable, so its user was asked to reconnect
|
||||||
|
Wi-Fi and verify the short name. Existing clients may keep their previous DHCP
|
||||||
|
DNS settings until reconnection or lease renewal.
|
||||||
|
|
||||||
|
#### Windows application resolution on workgroup clients
|
||||||
|
|
||||||
|
On October 1, LCI-77 resolved SI-04 again after returning to CED, but lost Windows
|
||||||
|
application resolution on Sala when its connection suffix disappeared. After the
|
||||||
|
persistent search-list repair, `System.Net.Dns.GetHostAddresses` resolved SI-04
|
||||||
|
and SGU-DC02 on both SSIDs. A TCP socket explicitly bound to LCI-77's Sala address
|
||||||
|
`192.168.55.201` connected by the short name `SGU-DC02` to `192.168.54.211:3389`
|
||||||
|
and received a 19-byte successful HYBRID/NLA negotiation response. This confirms
|
||||||
|
the RDP endpoint is reachable across VLANs; no authenticated desktop session
|
||||||
|
was tested. LCI-77 was returned to CED after validation.
|
||||||
|
|
||||||
|
A user screenshot from **SI-04** shows RDP error `0x104` before credentials:
|
||||||
|
the bare name SGU-DC02 is not found. A default `Resolve-DnsName` also reports
|
||||||
|
`ERROR_INVALID_NAME`, while `Resolve-DnsName -Type A -DnsOnly` returns the correct
|
||||||
|
server IP. DNS-server answers alone do not verify the Windows application
|
||||||
|
resolver. The user applied this elevated client repair on SI-04 and returned
|
||||||
|
successful application-resolution and RDP TCP checks:
|
||||||
|
|
||||||
|
```powershell
|
||||||
|
$s = @('lci.lasalle.mx') + @((Get-DnsClientGlobalSetting).SuffixSearchList) + @(Get-DnsClient | Select-Object -ExpandProperty ConnectionSpecificSuffix)
|
||||||
|
Set-DnsClientGlobalSetting -SuffixSearchList @($s | Where-Object { $_ } | Select-Object -Unique)
|
||||||
|
Clear-DnsClientCache
|
||||||
|
[System.Net.Dns]::GetHostAddresses('SGU-DC02')
|
||||||
|
Test-NetConnection SGU-DC02 -Port 3389
|
||||||
|
```
|
||||||
|
|
||||||
|
SI-04's application resolver returned `192.168.54.211`. `Test-NetConnection`
|
||||||
|
returned `TcpTestSucceeded: True` using Wi-Fi 2, source `192.168.55.138`, target
|
||||||
|
`SGU-DC02`, and port 3389. This confirms the client DNS repair and connectivity;
|
||||||
|
an authenticated desktop session has not been confirmed. The suffix change is
|
||||||
|
persistent and does not require adding SI-04 to the domain. The same repair has
|
||||||
|
not yet been applied to SI-03.
|
||||||
|
|
||||||
|
This configures DNS lookup without domain enrollment. For an immediate test,
|
||||||
|
use `SGU-DC02.lci.lasalle.mx` in Remote Desktop. SI-03's WinRM ports and DCOM
|
||||||
|
management were unavailable; an authenticated session from that PC remains
|
||||||
|
unverified. On SGU-DC02, RDP is enabled, TermService is running, TCP 3389 listens,
|
||||||
|
and the existing RDP firewall rule already allows access. No additional firewall
|
||||||
|
opening or NLA change was needed.
|
||||||
|
|
||||||
|
Internal DNS now depends on SGU-DC02 in Sala as it already does in CED. Personal
|
||||||
|
Wi-Fi authentication still does not require RADIUS or domain membership. To roll
|
||||||
|
back this follow-up, restore Sala's DNS selection to **Default**, disable the
|
||||||
|
short-name helper invocation, and remove only the eight owned bare-name zones
|
||||||
|
after comparing their A records with `short-names-owned.json`. Keep the existing
|
||||||
|
secure domain zone and the original approved-name synchronization task.
|
||||||
|
|
||||||
|
To recover the previous Wi-Fi, first provision an existing known-good profile
|
||||||
|
and reconnection task on SGU-DC02 and affected PCs. Then restore Aula Flexible on
|
||||||
|
VLAN 53, or re-enable the preserved Sala de Desarrollo network, as appropriate.
|
||||||
|
Disable the CED GPO links and remove the CED maintenance/enrollment tasks when
|
||||||
|
rolling back the managed configuration. Use each client's `CED-dns-before.json`
|
||||||
|
to restore DNS. For WAC, restore the saved frontend settings and certificate
|
||||||
|
binding before removing the public trust policy. Do not remove unrelated GPOs,
|
||||||
|
profiles, certificates, or guest networks.
|
||||||
|
|
||||||
|
The existing Configuration Manager 2103 / Windows Server 2025 support limitation
|
||||||
|
is not changed by this network repair.
|
||||||
|
|
||||||
|
## References
|
||||||
|
|
||||||
|
- [Microsoft native WLAN Group Policy protocol](https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-gpwl/481e4e64-5e95-4ada-aae8-ec93ed69559a)
|
||||||
|
- [Native Wi-Fi profile storage and key protection](https://learn.microsoft.com/en-us/windows/win32/api/wlanapi/nf-wlanapi-wlansetprofile)
|
||||||
|
- [Computer startup script protocol](https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-gpscr/ff1fd13e-1e18-4160-9b50-0263e108e5e1)
|
||||||
|
- [Configuration Manager client source selection](https://learn.microsoft.com/en-us/intune/configmgr/core/servers/deploy/configure/boundary-groups-distribution-points)
|
||||||
|
- [Domain DNS policy cmdlet](https://learn.microsoft.com/en-us/powershell/module/dnsclient/add-dnsclientnrptrule)
|
||||||
|
- [Windows DNS suffix search and application resolution](https://learn.microsoft.com/en-us/windows-server/networking/dns/queries-lookups)
|
||||||
|
- [Configuration Manager client monitoring](https://learn.microsoft.com/en-us/intune/configmgr/core/clients/manage/monitor-clients)
|
||||||
|
- [Configuration Manager connection ports](https://learn.microsoft.com/en-us/intune/configmgr/core/plan-design/hierarchy/ports)
|
||||||
@@ -0,0 +1,54 @@
|
|||||||
|
# Actualización Wi-Fi para el dominio existente
|
||||||
|
|
||||||
|
Este paquete publica la política **CED - Wi-Fi de salas** para las estaciones
|
||||||
|
`AF-*`, `SD-*` y `SI-*` de Centro de Experiencia Digital, dentro de Laboratorio.
|
||||||
|
Excluye servidores y estaciones `APPS-*`. Está preparado para el dominio
|
||||||
|
`lci.lasalle.mx`, el controlador principal `SGU-DC01` en `20.9.81.130` y el SSID
|
||||||
|
**Centro de Experiencia Digital**. Para otra infraestructura, revise estas
|
||||||
|
direcciones y los nombres en los scripts antes de publicar.
|
||||||
|
|
||||||
|
En el laboratorio actual la actualización ya está publicada en ambos
|
||||||
|
controladores. Las estaciones desconectadas necesitan una conexión inicial al
|
||||||
|
dominio para obtenerla. Una vez conectadas, en PowerShell como administrador:
|
||||||
|
|
||||||
|
```powershell
|
||||||
|
gpupdate.exe /target:computer /force
|
||||||
|
```
|
||||||
|
|
||||||
|
Si Windows solicita reiniciar para ejecutar la instalación de equipo, reinicie.
|
||||||
|
La política instala un perfil Wi-Fi de todos los usuarios, protegido por Windows,
|
||||||
|
que funciona antes del inicio de sesión y después de cerrarla. Conserva el
|
||||||
|
selector de redes para emergencias. Las otras redes guardadas se conectan
|
||||||
|
manualmente; una conexión alternativa elegida a mano se respeta.
|
||||||
|
|
||||||
|
## Publicación administrativa
|
||||||
|
|
||||||
|
Ejecute en SGU-DC01 con permisos de administración de dominio y GPO. Mantenga
|
||||||
|
juntos todos los archivos del paquete. Proporcione un perfil Personal WPA2/WPA3 AES
|
||||||
|
con su clave en una ubicación privada accesible solamente por administradores.
|
||||||
|
No lo coloque en SYSVOL, repositorios, notas de release ni carpetas compartidas.
|
||||||
|
|
||||||
|
```powershell
|
||||||
|
.\Set-SguCedWifiPolicy.ps1 -ProfilePath 'C:\ruta-privada\CED.xml' -DomainController SGU-DC01
|
||||||
|
.\Sync-SguCedWifiReaders.ps1 -DomainController SGU-DC01 -InstallRefreshTask
|
||||||
|
```
|
||||||
|
|
||||||
|
La publicación usa WLAN nativo de Windows y un script de inicio de equipo de
|
||||||
|
Directiva de grupos. La recuperación adicional se ejecuta como SYSTEM al
|
||||||
|
arrancar, terminar una actualización de políticas, cerrar sesión o conectar
|
||||||
|
Wi-Fi; no sondea periódicamente. La clave se lee del objeto WLAN restringido de
|
||||||
|
AD usando autenticación de equipo con firma y cifrado LDAP; se conserva cifrada
|
||||||
|
en el almacén de perfiles de Windows. Los clientes priorizan DNS del controlador
|
||||||
|
principal y mantienen `SGU-DC02` solo como DNS de respaldo. Un bloque administrado
|
||||||
|
en `hosts` hace que el FQDN de `SGU-DC01` use su extremo público, sin cambiar la
|
||||||
|
dirección privada que los controladores usan para replicar. No hay contraseñas de
|
||||||
|
administrador en el cliente ni claves Wi-Fi en los scripts del paquete.
|
||||||
|
|
||||||
|
Configuration Manager se administra exclusivamente desde su GPO global de
|
||||||
|
SYSTEMCENTER. La GPO Wi-Fi no instala un segundo agente ni una tarea repetitiva.
|
||||||
|
Para consolidar el dominio existente, consulte `policy-consolidation.md` y use
|
||||||
|
`Merge-SguClientPolicies.ps1` en el principal.
|
||||||
|
|
||||||
|
El estado sin secretos queda en
|
||||||
|
`C:\ProgramData\LCI-Admin\CED-WiFi\machine-wifi-status.json`.
|
||||||
|
Consulte `ced-network-operations.md` para alcance, DNS y recuperación.
|
||||||
+105
-12
@@ -1,7 +1,12 @@
|
|||||||
# Enrolamiento obligatorio de clientes SGU
|
# Enrolamiento obligatorio de clientes SGU
|
||||||
|
|
||||||
Para una instalación limpia de Windows se prefiere el único punto de entrada
|
Para Windows 10 y Windows 11 se usa un solo paquete:
|
||||||
empaquetado:
|
|
||||||
|
- `sgu-windows-client-bootstrap-VERSION.zip` (x64, Pro, Enterprise o Education).
|
||||||
|
|
||||||
|
Extraer el ZIP y hacer doble clic en `Start-SguClientEnrollment.cmd`. Aceptar
|
||||||
|
UAC, introducir la IP del controlador y la cuenta del dominio con su contraseña.
|
||||||
|
También se puede indicar el servidor desde consola:
|
||||||
|
|
||||||
```bat
|
```bat
|
||||||
Start-SguClientEnrollment.cmd 192.168.50.10
|
Start-SguClientEnrollment.cmd 192.168.50.10
|
||||||
@@ -12,6 +17,73 @@ una clave privada y luego ejecuta la transacción proveedor-primero. Las
|
|||||||
instrucciones completas están en
|
instrucciones completas están en
|
||||||
[`bootstrap-recovery.md`](bootstrap-recovery.md).
|
[`bootstrap-recovery.md`](bootstrap-recovery.md).
|
||||||
|
|
||||||
|
El único dato de red necesario es la IPv4 del controlador. El bootstrap prueba
|
||||||
|
WinRM desde las direcciones de las interfaces conectadas, incluyendo túneles
|
||||||
|
VPN, empezando por la ruta elegida por Windows. Si ésta falla, prueba las demás
|
||||||
|
rutas disponibles. Cliente y servidor pueden estar en subredes distintas.
|
||||||
|
Si la red todavía está inicializando, reintenta el descubrimiento durante
|
||||||
|
20 segundos antes de informar el último diagnóstico.
|
||||||
|
Conserva DHCP, direcciones y puertas de enlace. Sólo si Windows elige otra
|
||||||
|
interfaz agrega una ruta persistente `/32` hacia ese servidor por la interfaz
|
||||||
|
comprobada; no modifica la ruta de Internet. Ante cualquier error conserva la
|
||||||
|
ventana y escribe el diagnóstico en
|
||||||
|
`C:\ProgramData\SGU\Bootstrap\Client\latest-error.log`.
|
||||||
|
|
||||||
|
El dominio DNS, NetBIOS y contenedor de equipos se descubren en la sesión
|
||||||
|
autenticada. Usa `OU=Laboratorio` si existe en la raíz del dominio y, en caso
|
||||||
|
contrario, el contenedor de equipos configurado en AD. Los parámetros
|
||||||
|
`-DomainName`, `-DomainNetbios` y `-ComputerOuDn` permiten validarlos o elegirlos
|
||||||
|
explícitamente. Para otra cuenta, editar el usuario sugerido como
|
||||||
|
`DOMINIO\usuario` o `usuario@dominio`. No se guardan contraseñas.
|
||||||
|
|
||||||
|
El enrolamiento también oculta las entradas de Cambio rápido de usuario mediante
|
||||||
|
una política de equipo. Docentes, administrativos y alumnos conservan la opción
|
||||||
|
de cerrar sesión, pero no pueden dejar una sesión abierta para cambiar a otra.
|
||||||
|
|
||||||
|
Si la IPv4 proporcionada es pública, el mismo flujo configura automáticamente
|
||||||
|
la conectividad directa. Después de autenticar WinRM, el servidor crea o reutiliza
|
||||||
|
un certificado DoH, publica DNS cifrado en TCP 443 y devuelve únicamente su
|
||||||
|
certificado público. El cliente lo confía, registra el servidor DoH, agrega la
|
||||||
|
regla NRPT y fija localmente los nombres del DC, dominio, broker y RustDesk a esa
|
||||||
|
IP. A continuación comprueba el registro SRV de AD y continúa con la unión. El
|
||||||
|
operador sigue introduciendo solamente IP del DC, usuario y contraseña.
|
||||||
|
|
||||||
|
El servidor o firewall perimetral debe autorizar previamente el segmento público
|
||||||
|
del laboratorio. En el bootstrap del servidor se hace con
|
||||||
|
`-PublicEnrollmentNetworks 200.13.89.0/24`; en Azure, con
|
||||||
|
`-PublicEnrollmentSourceAddressPrefixes 200.13.89.0/24`. La lista vacía no abre
|
||||||
|
puertos. Este modo requiere Windows 11 o una versión de Windows 10 que exponga
|
||||||
|
los cmdlets DNS-over-HTTPS; en equipos anteriores funciona si la red ya permite
|
||||||
|
DNS tradicional hacia el DC.
|
||||||
|
|
||||||
|
El DNS se configura mediante una regla NRPT para el dominio descubierto,
|
||||||
|
conservando los servidores DNS de los adaptadores y la resolución de Internet.
|
||||||
|
Las políticas DNS/VPN corporativas deben permitir resolver ese dominio.
|
||||||
|
El servidor necesita el bootstrap SGU (AD/DNS, WinRM, Auth Broker y RustDesk):
|
||||||
|
este paquete no es un enrolador genérico de Microsoft Entra ID ni instala SGU
|
||||||
|
en un directorio ajeno automáticamente. Se comprueban TCP 53, 88, 135, 389, 445,
|
||||||
|
5985 y 8443; la unión también requiere DNS/Kerberos por UDP y RPC dinámico
|
||||||
|
según la configuración de AD. Estas pruebas no sustituyen la unión real.
|
||||||
|
|
||||||
|
Una VPN de cualquier proveedor ya conectada utiliza el mismo lanzador. Para
|
||||||
|
instalar la VPN Azure IKEv2 se incluyen `Start-SguAzureClientEnrollment.cmd` e
|
||||||
|
`Install-SguAzureP2sClient.ps1` en el mismo ZIP para ambos Windows; la primera
|
||||||
|
instalación requiere perfil y certificados. La conectividad antes del inicio
|
||||||
|
de sesión depende de la VPN y sus políticas, no se puede deducir de la IP del DC.
|
||||||
|
|
||||||
|
Una interfaz con sólo APIPA (`169.254.x.x`), sin DHCP o sin ruta necesita que
|
||||||
|
el administrador configure la red o conecte la VPN. El bootstrap no inventa una
|
||||||
|
IP libre ni una puerta de enlace. Para una LAN estática se mantienen los
|
||||||
|
parámetros avanzados `-ClientIPv4Address`, `-ClientPrefixLength` y
|
||||||
|
`-NetworkInterfaceAlias`; la IP y la interfaz deben indicarse juntas.
|
||||||
|
|
||||||
|
El manifiesto usa `CompatibilityProfile: Auto`. No hay restricciones de VPN
|
||||||
|
por Windows 10/11; los nombres antiguos de perfil se aceptan como parámetros
|
||||||
|
obsoletos. Se valida x64, edición con unión a AD y Windows 10 desde 1607 o
|
||||||
|
Windows 11 (el runtime incluido es .NET 10; usar una edición/build compatible
|
||||||
|
con su ciclo de soporte). Credential Provider, mTLS, cuenta `alumno`, RustDesk,
|
||||||
|
monitorización y autorreparación conservan la misma implementación.
|
||||||
|
|
||||||
El flujo administrado instala y valida el Credential Provider **antes** de
|
El flujo administrado instala y valida el Credential Provider **antes** de
|
||||||
ejecutar `Add-Computer`. La pertenencia al dominio es el último cambio; si falta
|
ejecutar `Add-Computer`. La pertenencia al dominio es el último cambio; si falta
|
||||||
el runtime, un certificado, el registro COM, la directiva predeterminada o la
|
el runtime, un certificado, el registro COM, la directiva predeterminada o la
|
||||||
@@ -72,11 +144,14 @@ Orden de la transacción:
|
|||||||
1. instala .NET y los binarios versionados;
|
1. instala .NET y los binarios versionados;
|
||||||
2. registra COM, configura SGU como proveedor predeterminado y oculta el
|
2. registra COM, configura SGU como proveedor predeterminado y oculta el
|
||||||
último usuario que cerró sesión;
|
último usuario que cerró sesión;
|
||||||
3. instala el guard de autorreparación;
|
3. crea o actualiza la cuenta local estándar `alumno` con la contraseña
|
||||||
4. exige health mTLS del broker y ejecuta las comprobaciones locales;
|
inicial `ingenieria` sólo al crearla; si ya existe conserva su contraseña,
|
||||||
5. configura DNS del dominio;
|
la habilita y garantiza que no pertenezca a Administradores;
|
||||||
6. sólo entonces ejecuta `Add-Computer` en `OU=Laboratorio` y reinicia;
|
4. instala el guard de autorreparación;
|
||||||
7. al arrancar, el guard habilita RDP, NLA y WinRM y comprueba el estado final.
|
5. exige health mTLS del broker y ejecuta las comprobaciones locales;
|
||||||
|
6. configura DNS del dominio;
|
||||||
|
7. sólo entonces ejecuta `Add-Computer` en `OU=Laboratorio` y reinicia;
|
||||||
|
8. al arrancar, el guard habilita RDP, NLA y WinRM y comprueba el estado final.
|
||||||
|
|
||||||
La directiva de Windows **Assign a default credential provider** selecciona SGU
|
La directiva de Windows **Assign a default credential provider** selecciona SGU
|
||||||
por defecto. El instalador también habilita **Interactive logon: Don't display
|
por defecto. El instalador también habilita **Interactive logon: Don't display
|
||||||
@@ -112,6 +187,20 @@ 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
|
batería. El guard de enrolamiento vuelve a aplicar `powercfg /hibernate off` y
|
||||||
los tiempos en cero al inicio y diariamente.
|
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. 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
|
`HideEULAPage` no forma parte de esta GPO: es una opción de archivo Unattend para
|
||||||
la fase OOBE y Microsoft la reserva para pruebas de OEM/System Builder. La GPO
|
la fase OOBE y Microsoft la reserva para pruebas de OEM/System Builder. La GPO
|
||||||
usa las alternativas soportadas `DisablePrivacyExperience=1` y
|
usa las alternativas soportadas `DisablePrivacyExperience=1` y
|
||||||
@@ -133,8 +222,9 @@ Start-ScheduledTask -TaskName SGU-CredentialProvider-EnrollmentGuard
|
|||||||
|
|
||||||
Un resultado válido exige simultáneamente binario y registro COM, configuración,
|
Un resultado válido exige simultáneamente binario y registro COM, configuración,
|
||||||
certificados, .NET 10, proveedor SGU predeterminado, último usuario oculto,
|
certificados, .NET 10, proveedor SGU predeterminado, último usuario oculto,
|
||||||
enumeración local deshabilitada y proveedor de contraseña de Microsoft
|
enumeración local deshabilitada, cuenta local estándar `alumno` habilitada y
|
||||||
preservado. El script de reparación se encuentra en
|
fuera del grupo Administradores, y proveedor de contraseña de Microsoft
|
||||||
|
preservado. El guard recrea o corrige esa cuenta de forma idempotente. El script de reparación se encuentra en
|
||||||
`C:\ProgramData\SGU\Enrollment` con ACL exclusiva para `SYSTEM` y
|
`C:\ProgramData\SGU\Enrollment` con ACL exclusiva para `SYSTEM` y
|
||||||
administradores.
|
administradores.
|
||||||
|
|
||||||
@@ -142,12 +232,15 @@ administradores.
|
|||||||
|
|
||||||
El proveedor usa un mosaico genérico dedicado, no una credencial asociada al SID
|
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
|
anónimo de **Other user**. Windows muestra la imagen institucional y la etiqueta
|
||||||
`La Salle · Acceso SGU`; el encabezado `Acceso institucional SGU`
|
`Acceso Institucional`; el encabezado `Iniciar sesión` se publica como
|
||||||
se publica como `CPFT_LARGE_TEXT` solamente en el mosaico seleccionado. LogonUI
|
`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
|
elige la familia, el peso y el tamaño final y no expone opciones de tipografía a
|
||||||
un Credential Provider.
|
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
|
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
|
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
|
se elimina **Other user**: Microsoft recomienda conservar al menos un proveedor
|
||||||
|
|||||||
+2
-1
@@ -98,6 +98,7 @@ Get-Service SGUAuthBroker
|
|||||||
Get-NetTCPConnection -LocalPort 8443 -State Listen
|
Get-NetTCPConnection -LocalPort 8443 -State Listen
|
||||||
sc.exe qfailure SGUAuthBroker
|
sc.exe qfailure SGUAuthBroker
|
||||||
Get-ADOrganizationalUnit -Filter * -SearchBase 'OU=Usuarios-SGU,DC=lci,DC=lasalle,DC=mx'
|
Get-ADOrganizationalUnit -Filter * -SearchBase 'OU=Usuarios-SGU,DC=lci,DC=lasalle,DC=mx'
|
||||||
|
Get-ADGroup -Filter 'SamAccountName -like "SGU-*"' -SearchBase 'OU=Usuarios-SGU,DC=lci,DC=lasalle,DC=mx'
|
||||||
```
|
```
|
||||||
|
|
||||||
## 4. Broker preflight from Windows 10
|
## 4. Broker preflight from Windows 10
|
||||||
@@ -135,7 +136,7 @@ On Windows 10:
|
|||||||
```
|
```
|
||||||
|
|
||||||
Use Lithnet's `Invoke-CredUI` test utility when available, or sign out/restart
|
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**.
|
password provider available through **Other user**.
|
||||||
|
|
||||||
On the domain controller, apply the SGU user and computer policies once:
|
On the domain controller, apply the SGU user and computer policies once:
|
||||||
|
|||||||
@@ -0,0 +1,44 @@
|
|||||||
|
# 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. 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 `
|
||||||
|
-TargetOuDn 'OU=Laboratorio,DC=lci,DC=lasalle,DC=mx'
|
||||||
|
```
|
||||||
|
|
||||||
|
El script reutiliza la GPO, respalda una existente antes de modificarla y verifica
|
||||||
|
los valores escritos. Admite `-WhatIf`. El vínculo está habilitado y forzado, con
|
||||||
|
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. 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.
|
||||||
|
|
||||||
|
Los clientes deben tener el generador, el fondo base y las fuentes que ya entrega
|
||||||
|
el enrolamiento SGU. La política no reemplaza el generador ni modifica el fondo
|
||||||
|
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, 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.
|
||||||
|
|
||||||
|
Referencia: [configuración de fondos mediante GPO de Microsoft](https://learn.microsoft.com/windows/configuration/background/).
|
||||||
@@ -0,0 +1,122 @@
|
|||||||
|
# Enrolamiento de clientes Linux
|
||||||
|
|
||||||
|
El enrolador Linux incorpora una estación Debian/Ubuntu o RHEL/Fedora/Rocky/AlmaLinux a `lci.lasalle.mx` mediante `realmd`, `adcli`, Kerberos y SSSD. No instala el Credential Provider de Windows: Linux conserva su propio inicio de sesión PAM/SSSD. También instala RustDesk, lo dirige al servidor RustDesk autoalojado y registra el ID y la contraseña de acceso desatendido en el inventario protegido del controlador de dominio.
|
||||||
|
|
||||||
|
La contraseña de la cuenta autorizada para unir equipos se solicita directamente por `realmd`. Nunca se acepta como argumento, ni se escribe en archivos, registros o la línea de comandos.
|
||||||
|
|
||||||
|
## Requisitos de red
|
||||||
|
|
||||||
|
El equipo debe alcanzar por una interfaz privada al controlador de dominio, DNS y Kerberos. En el laboratorio:
|
||||||
|
|
||||||
|
| Servicio | Destino |
|
||||||
|
| --- | --- |
|
||||||
|
| Controlador y DNS | `192.168.50.10` |
|
||||||
|
| Dominio | `lci.lasalle.mx` |
|
||||||
|
| OU de equipos | `OU=Laboratorio,DC=lci,DC=lasalle,DC=mx` |
|
||||||
|
|
||||||
|
Para una VM Hyper-V con dos NIC, mantén el Internet en `Default Switch` y conecta una segunda NIC a `Laboratorio AD`. El enrolador puede configurar la segunda NIC sin modificar la ruta predeterminada:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
sudo bash ./Enroll-SguLinuxDomainClient.sh \
|
||||||
|
--domain-controller 192.168.50.10 \
|
||||||
|
--domain-interface eth0 \
|
||||||
|
--domain-address 192.168.50.12/24 \
|
||||||
|
--enable-ssh \
|
||||||
|
--enable-hyperv-enhanced-session
|
||||||
|
```
|
||||||
|
|
||||||
|
`--domain-interface` y `--domain-address` son opcionales como pareja. Si ya se aprovisionó la red privada mediante cloud-init, DHCP o gestión de configuración, omítelos y conserva únicamente `--domain-controller`.
|
||||||
|
|
||||||
|
El script se niega a reconfigurar una interfaz que posea la ruta predeterminada; así no deja a la máquina sin salida a Internet al agregar AD.
|
||||||
|
|
||||||
|
En Ubuntu con GNOME, cierra la sesión gráfica de **Sesión básica** antes de
|
||||||
|
entrar con el mismo usuario mediante **Sesión mejorada**. GNOME no admite dos
|
||||||
|
escritorios simultáneos del mismo usuario; intentar conservar ambos produce una
|
||||||
|
pantalla negra aunque XRDP haya autenticado correctamente. El inicio automático
|
||||||
|
de sesión de GDM también debe permanecer deshabilitado.
|
||||||
|
|
||||||
|
## Qué instala y configura
|
||||||
|
|
||||||
|
1. Instala `realmd`, `adcli`, SSSD, Kerberos y los módulos NSS/PAM adecuados para la familia de distribución.
|
||||||
|
2. Comprueba el registro DNS SRV de Active Directory y sincronización de hora ya existente.
|
||||||
|
3. Establece el nombre de host `NOMBRE.lci.lasalle.mx` antes de crear la cuenta de equipo.
|
||||||
|
4. Une el equipo con `adcli` en `OU=Laboratorio`.
|
||||||
|
5. Activa SSSD, creación de directorio personal mediante PAM y valida la contraseña de la cuenta de equipo con `adcli testjoin`. En distribuciones que habilitan los respondedores NSS/PAM de SSSD tanto en `sssd.conf` como mediante sockets de systemd, desactiva los sockets duplicados para evitar una colisión al arrancar.
|
||||||
|
6. Cuando se proporcionó la NIC privada, activa actualizaciones DNS dinámicas de SSSD en esa interfaz.
|
||||||
|
7. Con `--enable-ssh`, instala y habilita OpenSSH y abre únicamente el servicio SSH cuando el firewall local ya está activo.
|
||||||
|
8. Registra `lightdm` y `cinnamon-screensaver` como inicios interactivos ante las políticas GPO de SSSD. En equipos con LightDM oculta la lista de cuentas y conserva únicamente el ingreso manual: usuario y contraseña, necesario para el primer acceso de un usuario del dominio.
|
||||||
|
9. Con `--enable-hyperv-enhanced-session`, configura XRDP sobre Hyper-V sockets para que VMConnect pueda usar **Sesión mejorada**, repara certificados incompletos, registra `xrdp-sesman` en el mismo mapa interactivo y valida ambos servicios XRDP.
|
||||||
|
10. Instala el fondo azul, las fuentes Indivisa y un autoinicio compatible con Cinnamon, GNOME y XFCE. En cada sesión gráfica genera el saludo con el nombre del usuario y la ubicación/OU del equipo obtenidas de AD.
|
||||||
|
11. Instala RustDesk 1.4.9 desde el paquete oficial comprobado, configura exclusivamente el servidor institucional y crea una contraseña aleatoria de acceso desatendido. También fuerza el greeter de GDM o SDDM a usar X11, porque RustDesk no admite controlar la pantalla de acceso bajo Wayland; LightDM ya usa X11. La contraseña no se muestra en Linux: viaja cifrada con la clave pública del controlador y éste la conserva mediante su inventario protegido. Si el enrolador cambia el backend gráfico, reinicia el equipo al finalizar para activarlo.
|
||||||
|
|
||||||
|
El objeto de equipo aparece como `NOMBRE` en `OU=Laboratorio`. SSSD registra su registro A cuando la actualización DNS dinámica está activada.
|
||||||
|
|
||||||
|
## Inicio de sesión de dominio
|
||||||
|
|
||||||
|
Después de la unión se acepta directamente la clave institucional corta:
|
||||||
|
|
||||||
|
```text
|
||||||
|
al201428
|
||||||
|
```
|
||||||
|
|
||||||
|
El formato UPN explícito también permanece disponible:
|
||||||
|
|
||||||
|
```text
|
||||||
|
usuario@lci.lasalle.mx
|
||||||
|
```
|
||||||
|
|
||||||
|
En Linux Mint aparece únicamente el ingreso manual. Escribe la clave corta y
|
||||||
|
su contraseña; no se muestra una lista ni mosaicos de cuentas locales o del
|
||||||
|
dominio.
|
||||||
|
|
||||||
|
La primera sesión crea `/home/usuario@lci.lasalle.mx`. El valor predeterminado de SSSD conserva credenciales para desconexiones breves de la red; las contraseñas no son administradas ni almacenadas por el Auth Broker.
|
||||||
|
|
||||||
|
Para limitar quién puede iniciar sesión, incluye un grupo de AD:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
sudo bash ./Enroll-SguLinuxDomainClient.sh \
|
||||||
|
--domain-controller 192.168.50.10 \
|
||||||
|
--allow-group 'SG-Laboratorio-Linux-Users'
|
||||||
|
```
|
||||||
|
|
||||||
|
Ese modo ejecuta `realm deny --all` seguido de `realm permit --groups`; crea y administra el grupo antes de usarlo.
|
||||||
|
|
||||||
|
## Verificación y salida controlada
|
||||||
|
|
||||||
|
```bash
|
||||||
|
realm list
|
||||||
|
sudo adcli testjoin --domain=lci.lasalle.mx
|
||||||
|
getent passwd 'usuario@lci.lasalle.mx'
|
||||||
|
sudo sssctl domain-status lci.lasalle.mx
|
||||||
|
sudo sssctl user-checks usuario -a acct -s lightdm
|
||||||
|
sudo sssctl user-checks usuario -a acct -s cinnamon-screensaver
|
||||||
|
systemctl is-active rustdesk
|
||||||
|
sudo cat /var/lib/sgu/rustdesk/device.json
|
||||||
|
```
|
||||||
|
|
||||||
|
En el controlador de dominio, el mismo inventario protegido usado por Windows
|
||||||
|
muestra el ID de un cliente Linux y, únicamente bajo solicitud explícita de un
|
||||||
|
administrador, su contraseña de RustDesk:
|
||||||
|
|
||||||
|
```powershell
|
||||||
|
& C:\ProgramData\SGU\RustDesk\Get-SguRustDeskDevice.ps1
|
||||||
|
& C:\ProgramData\SGU\RustDesk\Get-SguRustDeskDevice.ps1 `
|
||||||
|
-ComputerName ALEX-LMINT -RevealPassword
|
||||||
|
```
|
||||||
|
|
||||||
|
Usa `--disable-rustdesk` sólo cuando una estación deba quedar expresamente sin
|
||||||
|
soporte remoto. `--rustdesk-registration-share` permite especificar el UNC del
|
||||||
|
controlador cuando una topología de DNS no puede resolver automáticamente el
|
||||||
|
controlador de dominio.
|
||||||
|
|
||||||
|
Para sacar un equipo del dominio de forma explícita:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
sudo realm leave lci.lasalle.mx
|
||||||
|
```
|
||||||
|
|
||||||
|
Esta última acción elimina la relación de confianza local; debe ejecutarse sólo durante baja o reconstrucción del equipo.
|
||||||
|
|
||||||
|
La personalización gráfica es deliberadamente opcional: si ImageMagick, LDAP o
|
||||||
|
la API del escritorio fallan, no revierte la unión ni impide iniciar sesión. Consulta
|
||||||
|
los detalles y las reglas de degradación en [welcome-wallpaper.md](welcome-wallpaper.md).
|
||||||
@@ -0,0 +1,122 @@
|
|||||||
|
# Monitoreo y registros de uso
|
||||||
|
|
||||||
|
El dominio usa **Windows Event Forwarding (WEF)** y el servicio nativo
|
||||||
|
**Windows Event Collector (Wecsvc)**. No instala un agente de telemetría y no
|
||||||
|
registra contraseñas, contenido de escritorio ni páginas visitadas.
|
||||||
|
|
||||||
|
## Datos recopilados
|
||||||
|
|
||||||
|
La suscripción `SGU-Lab-Monitoring` recibe desde los equipos de
|
||||||
|
`OU=Laboratorio`:
|
||||||
|
|
||||||
|
- inicios de sesión correctos y fallidos (`4624` y `4625`);
|
||||||
|
- cierre de sesión, desconexión y reconexión (`4634`, `4647`, `4778`, `4779`);
|
||||||
|
- arranque, apagado, reinicio y apagado inesperado (`12`, `13`, `41`, `1074`,
|
||||||
|
`6005`, `6006`, `6008`).
|
||||||
|
|
||||||
|
Con el identificador de sesión de Windows se obtiene quién usó qué equipo,
|
||||||
|
hora de entrada, hora de salida y duración. Los eventos fallidos conservan el
|
||||||
|
estado de Windows, pero nunca la contraseña introducida.
|
||||||
|
|
||||||
|
El broker escribe un registro separado de Windows llamado `SGU Auth Broker`.
|
||||||
|
Cada solicitud válida queda correlacionada mediante usuario institucional,
|
||||||
|
rol, `TraceId`, resultado y tiempo total. Los Event ID estables distinguen:
|
||||||
|
|
||||||
|
- `1000` autorización completada; `1001` credenciales rechazadas; `1002`
|
||||||
|
servicio no disponible; `1003` solicitud inválida;
|
||||||
|
- `1100` SGU aceptó la autenticación; `1101` timeout; `1102` fallo de red/DNS;
|
||||||
|
- `1200` enriquecimiento completado y cantidad de campos; `1201` HTML sin los
|
||||||
|
IDs admitidos; `1202` timeout; `1203` excepción; `1204` página opcional no
|
||||||
|
disponible; `1205` foto SGU no disponible o timeout; `1206` imagen rechazada
|
||||||
|
por tipo, tamaño o formato;
|
||||||
|
- `1300` fallo de sincronización AD; `1301` metadatos opcionales no aplicados;
|
||||||
|
`1302` membresía RDP opcional no aplicada; `1303` cuenta agregada a su grupo
|
||||||
|
institucional de Alumnos, Administrativos o Docentes; `1304` cambio de
|
||||||
|
contraseña denegado; `1305` foto opcional no aplicada en AD.
|
||||||
|
|
||||||
|
Los registros no almacenan HTML, contraseñas, hashes ni cuerpos de respuesta
|
||||||
|
de SGU. Solo la imagen JPEG validada se guarda en `thumbnailPhoto` del usuario
|
||||||
|
de Active Directory; sus bytes no aparecen en los eventos.
|
||||||
|
|
||||||
|
## Retención
|
||||||
|
|
||||||
|
`ForwardedEvents` tiene un límite de 512 MB. La tarea
|
||||||
|
`SGU-Monitoring-Retention` lo archiva diariamente en:
|
||||||
|
|
||||||
|
```text
|
||||||
|
C:\ProgramData\SGU\Monitoring\Archive
|
||||||
|
```
|
||||||
|
|
||||||
|
El mismo ciclo archiva `SGU Auth Broker` en `Archive\Broker`. Solo elimina
|
||||||
|
archivos `.evtx` cuya antigüedad supera **183 días**. La tarea
|
||||||
|
`SGU-Monitoring-Inventory` actualiza cada cinco minutos el inventario en:
|
||||||
|
|
||||||
|
```text
|
||||||
|
C:\ProgramData\SGU\Monitoring\Reports\machine-status.json
|
||||||
|
C:\ProgramData\SGU\Monitoring\Reports\machine-status.csv
|
||||||
|
```
|
||||||
|
|
||||||
|
`Encendida` significa que WinRM respondió en TCP 5985. `Apagada o inaccesible`
|
||||||
|
también puede significar que el equipo está arrancando, perdió la red o tiene
|
||||||
|
el puerto bloqueado; Active Directory por sí solo no conoce el estado eléctrico
|
||||||
|
instantáneo de un PC.
|
||||||
|
|
||||||
|
## Consultas
|
||||||
|
|
||||||
|
En el servidor, como administrador:
|
||||||
|
|
||||||
|
```powershell
|
||||||
|
# Estado actual de las máquinas
|
||||||
|
Get-Content 'C:\ProgramData\SGU\Monitoring\Reports\machine-status.json' -Raw |
|
||||||
|
ConvertFrom-Json | Format-Table ComputerName,Status,IPv4Address,LastDomainLogon
|
||||||
|
|
||||||
|
# Uso de los últimos seis meses
|
||||||
|
& 'C:\ProgramData\SGU\Monitoring\Get-SguUsageReport.ps1' |
|
||||||
|
Format-Table User,Computer,StartedAt,EndedAt,DurationMinutes,Result
|
||||||
|
|
||||||
|
# Un usuario o una máquina
|
||||||
|
& 'C:\ProgramData\SGU\Monitoring\Get-SguUsageReport.ps1' -UserName AL201428
|
||||||
|
& 'C:\ProgramData\SGU\Monitoring\Get-SguUsageReport.ps1' -ComputerName LCI-W11-01
|
||||||
|
|
||||||
|
# Diagnóstico del broker; admite -UserName, -Level, -EventId y -Text
|
||||||
|
& 'C:\ProgramData\SGU\Monitoring\Get-SguBrokerLog.ps1' -UserName AL201428 |
|
||||||
|
Format-Table TimeCreated,Level,EventId,EventName,Message -Wrap
|
||||||
|
& 'C:\ProgramData\SGU\Monitoring\Get-SguBrokerLog.ps1' -Level Warning
|
||||||
|
|
||||||
|
# Exportación
|
||||||
|
& 'C:\ProgramData\SGU\Monitoring\Get-SguUsageReport.ps1' `
|
||||||
|
-OutputCsv 'C:\ProgramData\SGU\Monitoring\Reports\usage.csv'
|
||||||
|
```
|
||||||
|
|
||||||
|
Para revisar la salud del colector:
|
||||||
|
|
||||||
|
```powershell
|
||||||
|
Get-Service Wecsvc
|
||||||
|
wecutil enum-subscription
|
||||||
|
wecutil get-subscriptionruntimestatus SGU-Lab-Monitoring
|
||||||
|
Get-WinEvent -LogName ForwardedEvents -MaxEvents 20
|
||||||
|
Get-WinEvent -LogName 'SGU Auth Broker' -MaxEvents 20
|
||||||
|
Get-ScheduledTask -TaskName 'SGU-Monitoring-*'
|
||||||
|
```
|
||||||
|
|
||||||
|
> **Windows Server 2025:** no consultes `ForwardedEvents` mediante
|
||||||
|
> `-FilterHashtable` ni XPath. Algunas compilaciones tienen una regresión que
|
||||||
|
> termina el servicio Windows Event Log (`wevtsvc.dll`, `0xc0000420`). El
|
||||||
|
> reporte incluido lee el canal sin consulta estructurada y aplica los filtros
|
||||||
|
> en memoria.
|
||||||
|
|
||||||
|
El bootstrap del servidor crea el colector, la suscripción y las tareas. El GPO
|
||||||
|
`SGU - Windows client experience` publica el Subscription Manager por FQDN. El
|
||||||
|
bootstrap y la reparación diaria del cliente habilitan las subcategorías de
|
||||||
|
auditoría y el acceso de `NETWORK SERVICE` al registro Security.
|
||||||
|
|
||||||
|
La suscripción usa `ContentFormat=Events`: conserva el XML original que emplea
|
||||||
|
el reporte y evita que cada cliente tenga que renderizar texto localizado antes
|
||||||
|
de enviarlo.
|
||||||
|
|
||||||
|
Referencias de Microsoft:
|
||||||
|
|
||||||
|
- <https://learn.microsoft.com/en-us/windows/win32/wec/setting-up-a-source-initiated-subscription>
|
||||||
|
- <https://learn.microsoft.com/en-us/windows-server/administration/windows-commands/wecutil>
|
||||||
|
- <https://learn.microsoft.com/en-us/windows/security/threat-protection/auditing/event-4624>
|
||||||
|
- <https://learn.microsoft.com/en-us/windows/security/threat-protection/auditing/event-4634>
|
||||||
@@ -0,0 +1,96 @@
|
|||||||
|
# Consolidación de políticas del laboratorio
|
||||||
|
|
||||||
|
La configuración vigente tiene un responsable por función. Las GPO se ven en
|
||||||
|
`gpmc.msc`; sus scripts se guardan en
|
||||||
|
`\\SGU-DC01.lci.lasalle.mx\SYSVOL\lci.lasalle.mx\Policies\{GUID}\Machine\Scripts`.
|
||||||
|
Las tareas se ven en `taskschd.msc` de cada equipo. Los servicios instalados se
|
||||||
|
administran en `services.msc`.
|
||||||
|
|
||||||
|
| Función | Responsable | Cuándo se ejecuta |
|
||||||
|
| --- | --- | --- |
|
||||||
|
| DNS del dominio en CED | CED - DNS de dominio; configuración compartida `ced-network.json` | Actualización nativa de políticas |
|
||||||
|
| Perfil Wi-Fi de AF, SD y SI | CED - Wi-Fi de salas; WLAN AutoConfig y `CED WiFi policy connection` | Arranque, políticas de equipo, cierre de sesión y conexión Wi-Fi |
|
||||||
|
| Proveedor de credenciales | SGU - Credential Provider update | Arranque; comprueba la instalación antes de descargar |
|
||||||
|
| RDP, WinRM y firewall de administración | La Salle - Workstation remote management | GPO nativa y un único auxiliar de arranque |
|
||||||
|
| Agente ConfigMgr | LCI-ConfigMgr2509-ClientRegistration; SYSTEMCENTER | Registro de la tarea por GPO, arranque y disponibilidad de red |
|
||||||
|
| Agente SCOM | LCI - SCOM agent deployment; SYSTEMCENTER | Registro de la tarea por GPO, arranque y disponibilidad de red |
|
||||||
|
| Inventario auxiliar de Azure | SGU-Monitoring-Inventory | Cada hora; no representa el monitoreo continuo de SCOM |
|
||||||
|
| Retención de eventos | SGU-Monitoring-Retention | Diariamente |
|
||||||
|
|
||||||
|
ConfigMgr y SCOM conservan sus instaladores con comprobación de versión, sitio,
|
||||||
|
clave de confianza o grupo de administración. Ya no tienen un temporizador de
|
||||||
|
30 minutos. Sus tareas permiten dos reintentos a intervalos de cinco minutos
|
||||||
|
solo cuando falla una ejecución. Para publicar una nueva versión del agente,
|
||||||
|
actualice el origen de SYSTEMCENTER y su GPO; un arranque o una conexión de red
|
||||||
|
también vuelve a comprobar la versión. Los agentes continúan funcionando entre
|
||||||
|
estas comprobaciones.
|
||||||
|
|
||||||
|
La GPO Wi-Fi deja de instalar ConfigMgr. La GPO de experiencia de Windows
|
||||||
|
conserva la configuración visual y el auxiliar de administradores, pero deja
|
||||||
|
de repetir la configuración de acceso remoto. El guardián antiguo del proveedor
|
||||||
|
se deshabilita cuando se verifican proveedor, valores de inicio de sesión,
|
||||||
|
servicios, reenvío de eventos y RustDesk cuando estaba configurado. Se conservan
|
||||||
|
sus archivos y una copia de su tarea. No reinstala el paquete antiguo cada día.
|
||||||
|
|
||||||
|
## DNS y conectividad
|
||||||
|
|
||||||
|
En CED, `ced-network.json` define `20.9.81.130` primero y `192.168.54.211` como
|
||||||
|
respaldo, tanto para el adaptador como para NRPT. Solo AF/SD/SI de CED reciben
|
||||||
|
la modificación del adaptador Wi-Fi. El extremo público de SGU-DC01 y el nombre
|
||||||
|
del dominio se mantienen en un bloque administrado de `hosts`; los alias de
|
||||||
|
broker y RustDesk existentes se conservan. Una entrada manual contradictoria
|
||||||
|
provoca un error para revisión, sin sobrescribirla.
|
||||||
|
|
||||||
|
Una red de emergencia elegida manualmente conserva sus DNS por DHCP y no se
|
||||||
|
fuerza una desconexión. NRPT mantiene la resolución del dominio. Esa resolución
|
||||||
|
y el acceso a AD dependen de que el extremo permita la red de salida utilizada.
|
||||||
|
El orden de DNS expresa preferencia; Active Directory todavía puede elegir
|
||||||
|
otro controlador mediante DC Locator y sus sitios. No se altera la replicación
|
||||||
|
privada de los controladores.
|
||||||
|
|
||||||
|
## Aplicación a clientes
|
||||||
|
|
||||||
|
Con conexión al dominio y canal seguro sano, ejecutar como administrador:
|
||||||
|
|
||||||
|
```powershell
|
||||||
|
Test-ComputerSecureChannel -Server SGU-DC01.lci.lasalle.mx
|
||||||
|
gpupdate.exe /target:computer /force
|
||||||
|
```
|
||||||
|
|
||||||
|
Después reiniciar para procesar los scripts de arranque. No volver a enrolar
|
||||||
|
una estación que ya tiene el canal seguro sano. Los equipos desconectados
|
||||||
|
reciben la configuración cuando vuelven a comunicarse con el dominio.
|
||||||
|
|
||||||
|
Estado Wi-Fi sin claves:
|
||||||
|
`C:\ProgramData\LCI-Admin\CED-WiFi\machine-wifi-status.json`.
|
||||||
|
Respaldos de tareas retiradas:
|
||||||
|
`C:\ProgramData\LCI-Admin\PolicyConsolidation\*.before.xml`.
|
||||||
|
|
||||||
|
## Publicación y reversión
|
||||||
|
|
||||||
|
En el principal, con permisos administrativos, conservar una copia nativa de
|
||||||
|
las GPO mediante `Backup-GPO`. Ejecutar desde el conjunto completo de scripts:
|
||||||
|
|
||||||
|
```powershell
|
||||||
|
.\Merge-SguClientPolicies.ps1 -WhatIf
|
||||||
|
.\Merge-SguClientPolicies.ps1
|
||||||
|
```
|
||||||
|
|
||||||
|
Este comando consolida GPO existentes con identificadores conocidos del
|
||||||
|
laboratorio; no crea un bosque. Verifica el esquema de las tareas con Windows,
|
||||||
|
actualiza las versiones de AD y SYSVOL solo al cambiar archivos, y conserva el
|
||||||
|
paquete y SHA-256 previamente fijados para el proveedor.
|
||||||
|
|
||||||
|
Para revertir, restaurar individualmente las GPO modificadas desde su BackupId,
|
||||||
|
actualizar políticas y reiniciar. Las tareas antiguas deshabilitadas pueden
|
||||||
|
habilitarse con `Enable-ScheduledTask`; antes de restaurar el guardián, retirar
|
||||||
|
`ProviderManagedByGpo` de
|
||||||
|
`HKLM:\SOFTWARE\Policies\LaSalle\ClientMaintenance`. El cambio de hosts tiene
|
||||||
|
copia en `C:\ProgramData\LCI-Admin\CED-WiFi\hosts.before-consolidation`.
|
||||||
|
Restaurar archivos de una estación usando exclusivamente su propia copia.
|
||||||
|
|
||||||
|
Se conservan los lectores de permisos Wi-Fi, el mantenimiento DNS de Sala
|
||||||
|
Inmersiva, el procesamiento de altas Linux de RustDesk y la selección de origen
|
||||||
|
privado de DC02: atienden funciones vigentes. No se cambia su frecuencia sin
|
||||||
|
reemplazar esas funciones. Los fondos, restricciones de navegación, perfiles,
|
||||||
|
servicios y cuentas existentes permanecen bajo sus políticas actuales.
|
||||||
@@ -0,0 +1,42 @@
|
|||||||
|
# SGU Credential Provider 0.6.0
|
||||||
|
|
||||||
|
Continúa la serie publicada después de `0.5.11`; no sustituye ni renumera versiones anteriores.
|
||||||
|
|
||||||
|
## Cambios
|
||||||
|
|
||||||
|
- Se incorpora al bootstrap la GPO `SGU - Laboratorio wallpaper protection`:
|
||||||
|
restringe el cambio de fondo en equipos Windows de Laboratorio y sus OU hijas
|
||||||
|
mediante loopback Merge, manteniendo el fondo personalizado de SGU.
|
||||||
|
- Se publican los cambios pendientes de roaming: Azure Files privado, recursos
|
||||||
|
separados para perfiles y carpetas, configuración de AD DS/ACL, perfiles
|
||||||
|
FSLogix por grupo AD/DO y rutas de Escritorio/Documentos para AL.
|
||||||
|
- El enrolamiento Windows admite un instalador FSLogix opcional y verifica su
|
||||||
|
firma Microsoft. Se incluyen scripts y documentación en los paquetes.
|
||||||
|
- Se incluyen las mejoras ya presentes en main desde el último lanzamiento:
|
||||||
|
ubicación del fondo por equipo/OU y pantalla de bloqueo mediante PersonalizationCSP.
|
||||||
|
|
||||||
|
## Alcance y precauciones
|
||||||
|
|
||||||
|
- Roaming requiere un piloto de inicio/cierre de sesión, permisos entre usuarios,
|
||||||
|
desconexión de VPN y recuperación de datos. Esta publicación no lo despliega ni
|
||||||
|
lo activa en el dominio existente. Los perfiles locales no se eliminan por
|
||||||
|
omisión; no habilite su eliminación sin respaldo y migración.
|
||||||
|
- La plantilla Azure agrega almacenamiento privado por omisión para P2S. El modo
|
||||||
|
de enrolamiento público directo requiere `-DeployUserRoaming $false`.
|
||||||
|
- La GPO de fondo necesita el generador SGU instalado. Las comprobaciones de GPO
|
||||||
|
no sustituyen la verificación visual tras un inicio de sesión de dominio.
|
||||||
|
- El bootstrap de servidor crea un bosque nuevo: no restaura SID, contraseñas ni
|
||||||
|
relaciones de confianza de un bosque anterior.
|
||||||
|
- Windows Home no admite unión al dominio; use una edición compatible. FSLogix
|
||||||
|
requiere verificar la licencia correspondiente.
|
||||||
|
|
||||||
|
## Descargas
|
||||||
|
|
||||||
|
- `sgu-windows-client-bootstrap-0.6.0.zip`
|
||||||
|
- `sgu-server-bootstrap-0.6.0.zip`
|
||||||
|
- `sgu-linux-client-bootstrap-0.6.0.zip`
|
||||||
|
- `sgu-azure-infrastructure-0.6.0.zip`
|
||||||
|
- `SHA256SUMS-0.6.0.txt`
|
||||||
|
|
||||||
|
Verifique los hashes SHA-256 antes de ejecutar los paquetes. No se incluyen
|
||||||
|
credenciales, certificados privados ni configuración local del entorno desplegado.
|
||||||
@@ -0,0 +1,39 @@
|
|||||||
|
# SGU Credential Provider 0.6.1
|
||||||
|
|
||||||
|
Continúa la serie publicada después de `0.6.0`.
|
||||||
|
|
||||||
|
## Cambios
|
||||||
|
|
||||||
|
- El configurador de roaming admite explícitamente Azure Files mediante endpoint
|
||||||
|
público con `-EndpointAccess Public`; el modo privado sigue siendo el valor
|
||||||
|
predeterminado.
|
||||||
|
- Se corrige la generación del nombre de la identidad de almacenamiento para
|
||||||
|
respetar el límite de 15 caracteres de una cuenta de equipo de Active
|
||||||
|
Directory.
|
||||||
|
- Las ACL de `profiles` y `redirected` aplican mínimo privilegio en la raíz: los
|
||||||
|
grupos autorizados pueden crear su directorio, pero no modificar ni eliminar
|
||||||
|
directorios ajenos; `CREATOR OWNER` conserva el control dentro del directorio
|
||||||
|
propio.
|
||||||
|
- Se documenta la secuencia de despliegue con firewall de Azure Storage en modo
|
||||||
|
`Deny`, autorizando finalmente sólo la red institucional `200.13.89.0/24`.
|
||||||
|
|
||||||
|
## Validación del despliegue
|
||||||
|
|
||||||
|
- Azure Files usa autenticación AD DS con Kerberos AES-256.
|
||||||
|
- `AF-02` y `AF-03` validaron ticket Kerberos, TCP 445 y lectura/escritura en los
|
||||||
|
shares `profiles` y `redirected`.
|
||||||
|
- FSLogix 26.08 (`3.26.826.17182`) quedó instalado y activo en ambos clientes.
|
||||||
|
- La GPO de FSLogix mantiene una base deshabilitada y se habilita sólo para los
|
||||||
|
SID de `SGU-Docentes` y `SGU-Administrativos`.
|
||||||
|
- La GPO de Alumnos redirige únicamente Escritorio y Documentos.
|
||||||
|
|
||||||
|
## Descargas
|
||||||
|
|
||||||
|
- `sgu-windows-client-bootstrap-0.6.1.zip`
|
||||||
|
- `sgu-server-bootstrap-0.6.1.zip`
|
||||||
|
- `sgu-linux-client-bootstrap-0.6.1.zip`
|
||||||
|
- `sgu-azure-infrastructure-0.6.1.zip`
|
||||||
|
- `SHA256SUMS-0.6.1.txt`
|
||||||
|
|
||||||
|
Verifique los hashes SHA-256 antes de ejecutar los paquetes. No se incluyen
|
||||||
|
credenciales, claves de almacenamiento ni artefactos temporales del despliegue.
|
||||||
@@ -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.
|
||||||
@@ -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.
|
||||||
@@ -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.
|
||||||
@@ -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.
|
||||||
@@ -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.
|
||||||
@@ -0,0 +1,19 @@
|
|||||||
|
# v0.6.19 — SGU password authority
|
||||||
|
|
||||||
|
- Add a fine-grained Active Directory password policy scoped to the three
|
||||||
|
`SGU-*` role groups. A password accepted by SGU is stored unchanged in AD,
|
||||||
|
including short passwords that the default domain complexity policy rejects.
|
||||||
|
Other domain accounts keep their existing policy.
|
||||||
|
- Apply and verify this policy during server bootstrap. Existing SGU accounts
|
||||||
|
receive it through their role-group membership.
|
||||||
|
- Stop institutional login immediately when SGU explicitly rejects a password.
|
||||||
|
When SGU accepts it but AD synchronization fails, show a distinct error
|
||||||
|
instead of trying an older AD password.
|
||||||
|
- Preserve the documented cached-domain fallback only while the broker or SGU
|
||||||
|
is genuinely unavailable.
|
||||||
|
|
||||||
|
Operational validation: on the domain controller, disposable users in each of
|
||||||
|
`SGU-Alumnos`, `SGU-Administrativos`, and `SGU-Docentes` accepted a three-character
|
||||||
|
password and were removed after the test. The three originally reported
|
||||||
|
accounts still require a real SGU sign-in to finish AD provisioning; no student
|
||||||
|
password was requested or stored for testing.
|
||||||
@@ -0,0 +1,36 @@
|
|||||||
|
# SGU Credential Provider 0.6.2
|
||||||
|
|
||||||
|
Continúa la serie publicada después de `0.6.1`.
|
||||||
|
|
||||||
|
## Cambios
|
||||||
|
|
||||||
|
- Se agrega despliegue automático e idempotente de FSLogix 26.08 mediante una
|
||||||
|
GPO de inicio de equipo ligada a `OU=Laboratorio`.
|
||||||
|
- El publicador verifica la firma Authenticode de Microsoft y el SHA-256 del
|
||||||
|
instalador antes de copiarlo al SYSVOL.
|
||||||
|
- Los equipos que estaban apagados reciben e instalan FSLogix en su siguiente
|
||||||
|
arranque; no se emplean tareas programadas.
|
||||||
|
- El script queda incluido en el paquete de servidor y la guía de roaming
|
||||||
|
documenta su publicación y comprobación.
|
||||||
|
|
||||||
|
## Validación del despliegue
|
||||||
|
|
||||||
|
- La GPO `SGU - FSLogix client deployment` está enlazada y sus versiones de AD
|
||||||
|
y SYSVOL coinciden.
|
||||||
|
- El instalador publicado conserva firma válida de Microsoft y SHA-256
|
||||||
|
`0BAF7FE8195571060F0361B351E58FE6CD422AE521A96BAB3E66D900544E8A30`.
|
||||||
|
- `AF-02` y `AF-03` aplicaron la GPO y ejecutan `frxsvc` con FSLogix
|
||||||
|
`3.26.826.17182`.
|
||||||
|
- Azure Storage permanece en `defaultAction=Deny` y sólo autoriza
|
||||||
|
`200.13.89.0/24`.
|
||||||
|
|
||||||
|
## Descargas
|
||||||
|
|
||||||
|
- `sgu-windows-client-bootstrap-0.6.2.zip`
|
||||||
|
- `sgu-server-bootstrap-0.6.2.zip`
|
||||||
|
- `sgu-linux-client-bootstrap-0.6.2.zip`
|
||||||
|
- `sgu-azure-infrastructure-0.6.2.zip`
|
||||||
|
- `SHA256SUMS-0.6.2.txt`
|
||||||
|
|
||||||
|
Verifique los hashes SHA-256 antes de ejecutar los paquetes. No se incluyen
|
||||||
|
credenciales, claves de almacenamiento ni artefactos temporales del despliegue.
|
||||||
@@ -0,0 +1,20 @@
|
|||||||
|
# v0.6.20 — SGU-scoped reversible password storage
|
||||||
|
|
||||||
|
- Enable reversible password storage only for members of the three SGU role
|
||||||
|
groups (`SGU-Alumnos`, `SGU-Administrativos`, and `SGU-Docentes`). The
|
||||||
|
domain-wide default password policy remains unchanged.
|
||||||
|
- Before synchronizing a valid Acceso SGU login, the broker enables the
|
||||||
|
per-account AD flag and then writes the exact SGU-accepted password. Existing
|
||||||
|
role-group members are repaired by server bootstrap and the password-policy
|
||||||
|
deployment script.
|
||||||
|
- Add structured broker event 1306 when the per-account setting is enabled.
|
||||||
|
- Document that reversible storage allows a privileged directory-data reader to
|
||||||
|
recover the original password, and that existing passwords are rewritten only
|
||||||
|
after their next successful SGU password synchronization.
|
||||||
|
- Correct references that called the institutional system “SGO”; the product is
|
||||||
|
SGU.
|
||||||
|
|
||||||
|
The setting is intentionally limited to the SGU-managed role groups. Do not
|
||||||
|
apply it to unrelated domain users. Existing SGU accounts need a successful
|
||||||
|
Acceso SGU sign-in (or another authorized password reset) before their currently
|
||||||
|
stored password is rewritten using reversible encryption.
|
||||||
@@ -0,0 +1,15 @@
|
|||||||
|
# v0.6.21 — Disable reversible password storage for SGU accounts
|
||||||
|
|
||||||
|
- Set `ReversibleEncryptionEnabled` to false in the fine-grained policy scoped
|
||||||
|
to `SGU-Alumnos`, `SGU-Administrativos`, and `SGU-Docentes`.
|
||||||
|
- Clear the per-account reversible-encryption flag for existing members of those
|
||||||
|
role groups, and make bootstrap keep the flag disabled.
|
||||||
|
- Update the Auth Broker to clear the flag before synchronizing any password
|
||||||
|
accepted by SGU, so future and existing managed accounts stay on one-way
|
||||||
|
password storage.
|
||||||
|
- Add broker event 1307 for an account whose reversible-storage flag is cleared.
|
||||||
|
|
||||||
|
The default domain policy remains unchanged and disabled. Password values that
|
||||||
|
were already stored reversibly are not transformed by changing these settings;
|
||||||
|
they are replaced using one-way storage when SGU next resets the password. A
|
||||||
|
successful Acceso SGU sign-in performs that synchronization.
|
||||||
@@ -0,0 +1,54 @@
|
|||||||
|
# v0.6.22 — Wi-Fi de equipo antes del inicio de sesión
|
||||||
|
|
||||||
|
Corrige las estaciones de Centro de Experiencia Digital que perdían Wi-Fi al
|
||||||
|
cerrar sesión y no podían contactar al dominio para el primer acceso de un
|
||||||
|
usuario.
|
||||||
|
|
||||||
|
- La GPO **CED - Wi-Fi de salas** prepara un perfil de todos los usuarios
|
||||||
|
**CED - Equipo**, con conexión automática a **Centro de Experiencia Digital**.
|
||||||
|
Windows protege la clave en su almacén de perfiles de equipo.
|
||||||
|
- Alcance: estaciones miembro `AF-*`, `SD-*` y `SI-*` bajo la OU Centro de
|
||||||
|
Experiencia Digital dentro de Laboratorio. Los servidores y `APPS-*`, que usan
|
||||||
|
Ethernet, quedan excluidos por filtro WMI y comprobación local.
|
||||||
|
- Conserva el selector de redes en el inicio de sesión. Las demás redes guardadas
|
||||||
|
se conectan manualmente para emergencias; la recuperación habitual respeta una
|
||||||
|
conexión alternativa elegida por el usuario y restaura su DNS por DHCP.
|
||||||
|
- Sustituye la reconexión periódica del cliente por recuperación ante eventos de
|
||||||
|
arranque, políticas, cierre de sesión y conexión Wi-Fi. Una configuración ya
|
||||||
|
correcta no reinstala el perfil ni vuelve a registrar la tarea.
|
||||||
|
- La provisión inicial consulta el controlador local mediante LDAP con firma y
|
||||||
|
cifrado, usando la cuenta del equipo. Evita intentar acceder a la IP privada
|
||||||
|
del controlador Azure desde estaciones sin esa ruta.
|
||||||
|
- Identifica la conexión mediante estado nativo y eventos WLAN cuando Windows
|
||||||
|
restringe la consulta del SSID, sin cambiar el consentimiento de ubicación.
|
||||||
|
- La publicación de la GPO es idempotente y mantiene la clave fuera de SYSVOL y
|
||||||
|
de los archivos del release.
|
||||||
|
|
||||||
|
## Paquetes
|
||||||
|
|
||||||
|
- **sgu-ced-wifi-policy-0.6.22.zip**: scripts y guía para actualizar la política
|
||||||
|
Wi-Fi de este dominio existente. No requiere ejecutar el bootstrap del bosque.
|
||||||
|
- Se mantienen los paquetes de bootstrap Windows, servidor, Linux e
|
||||||
|
infraestructura Azure. El paquete de servidor incluye también los scripts
|
||||||
|
necesarios para publicar esta corrección Wi-Fi.
|
||||||
|
- **SHA256SUMS-0.6.22.txt** permite verificar los cinco ZIP.
|
||||||
|
|
||||||
|
La política ya está publicada en los dos controladores del laboratorio. Una
|
||||||
|
estación desconectada necesita conectividad inicial al dominio para obtenerla;
|
||||||
|
después puede ejecutar `gpupdate /target:computer /force` y reiniciar si Windows
|
||||||
|
lo solicita. El perfil de equipo queda disponible sin sesión iniciada.
|
||||||
|
|
||||||
|
El paquete específico Wi-Fi está configurado para `lci.lasalle.mx`, el SSID CED y
|
||||||
|
el controlador local `192.168.54.211`; revise sus parámetros antes de reutilizarlo
|
||||||
|
en otra infraestructura. El bootstrap de servidor crea un bosque nuevo: para
|
||||||
|
actualizar el dominio existente use el paquete Wi-Fi y su README.
|
||||||
|
|
||||||
|
## Validación
|
||||||
|
|
||||||
|
- Compilación Release de Auth Broker y Credential Provider.
|
||||||
|
- 71 pruebas correctas: 42 del núcleo, 22 del broker y 7 del proveedor.
|
||||||
|
- Análisis sintáctico de los scripts y compilación del auxiliar nativo en
|
||||||
|
Windows PowerShell 5.1.
|
||||||
|
- Verificación SHA-256 de cada archivo de los manifiestos y de los cinco ZIP.
|
||||||
|
- Segunda publicación idéntica de la GPO sin cambios y archivos de política
|
||||||
|
coincidentes en SYSVOL de ambos controladores.
|
||||||
@@ -0,0 +1,25 @@
|
|||||||
|
# v0.6.23 — Consolidación de políticas
|
||||||
|
|
||||||
|
Unifica el mantenimiento del laboratorio conservando la configuración útil:
|
||||||
|
|
||||||
|
- DNS del adaptador y NRPT de CED prefieren SGU-DC01; DC02 queda como respaldo.
|
||||||
|
Una única configuración compartida evita que los auxiliares se contradigan.
|
||||||
|
- Wi-Fi de equipo antes de iniciar sesión y después de cerrarla, con recuperación
|
||||||
|
por eventos y selección manual de una red de emergencia.
|
||||||
|
- Una GPO mantiene el acceso remoto. El enrolamiento ConfigMgr antiguo de CED
|
||||||
|
deja de instalarse desde la GPO Wi-Fi.
|
||||||
|
- Las tareas de instalación ConfigMgr y SCOM pasan de cada 30 minutos a eventos
|
||||||
|
de registro por GPO, arranque y conexión de red. Conservan versiones objetivo,
|
||||||
|
configuración y dos reintentos limitados ante fallos.
|
||||||
|
- El guardián antiguo del proveedor se retira después de comprobar los servicios
|
||||||
|
y la configuración que lo sustituyen; sus archivos y tareas quedan respaldados.
|
||||||
|
- El inventario auxiliar de Azure pasa de cinco minutos a una hora; se conservan
|
||||||
|
SCOM, la retención de eventos, las políticas visuales y las de navegación.
|
||||||
|
|
||||||
|
`Merge-SguClientPolicies.ps1` actualiza el dominio existente. No ejecute el
|
||||||
|
bootstrap de creación de bosque para aplicar esta consolidación. Consulte
|
||||||
|
`policy-consolidation.md` para responsables, aplicación, límites y reversión.
|
||||||
|
|
||||||
|
La consolidación de GPO conserva el paquete y SHA-256 del proveedor ya fijados
|
||||||
|
en el dominio. Esta versión cambia los scripts de mantenimiento, sin modificar
|
||||||
|
el código de autenticación del proveedor.
|
||||||
@@ -0,0 +1,29 @@
|
|||||||
|
# v0.6.24 — Consolidación de políticas
|
||||||
|
|
||||||
|
Unifica el mantenimiento del laboratorio conservando la configuración útil:
|
||||||
|
|
||||||
|
- DNS del adaptador y NRPT de CED prefieren SGU-DC01; DC02 queda como respaldo.
|
||||||
|
Una única configuración compartida evita que los auxiliares se contradigan.
|
||||||
|
- Wi-Fi de equipo antes de iniciar sesión y después de cerrarla, con recuperación
|
||||||
|
por eventos y selección manual de una red de emergencia.
|
||||||
|
- Una GPO mantiene el acceso remoto. El enrolamiento ConfigMgr antiguo de CED
|
||||||
|
deja de instalarse desde la GPO Wi-Fi.
|
||||||
|
- Las tareas de instalación ConfigMgr y SCOM pasan de cada 30 minutos a eventos
|
||||||
|
de registro por GPO, arranque y conexión de red. Conservan versiones objetivo,
|
||||||
|
configuración y dos reintentos limitados ante fallos.
|
||||||
|
- El guardián antiguo del proveedor se retira después de comprobar los servicios
|
||||||
|
y la configuración que lo sustituyen; sus archivos y tareas quedan respaldados.
|
||||||
|
- El inventario auxiliar de Azure pasa de cinco minutos a una hora; se conservan
|
||||||
|
SCOM, la retención de eventos, las políticas visuales y las de navegación.
|
||||||
|
|
||||||
|
`Merge-SguClientPolicies.ps1` actualiza el dominio existente. No ejecute el
|
||||||
|
bootstrap de creación de bosque para aplicar esta consolidación. Consulte
|
||||||
|
`policy-consolidation.md` para responsables, aplicación, límites y reversión.
|
||||||
|
|
||||||
|
La consolidación de GPO conserva el paquete y SHA-256 del proveedor ya fijados
|
||||||
|
en el dominio. Esta versión cambia los scripts de mantenimiento, sin modificar
|
||||||
|
el código de autenticación del proveedor.
|
||||||
|
|
||||||
|
Corrige además la recuperación inicial del perfil WLAN cuando el equipo todavía
|
||||||
|
no tiene una copia local: LDAP usa la identidad de la cuenta de equipo con firma
|
||||||
|
y cifrado. Verificado como SYSTEM en una estación real contra SGU-DC01.
|
||||||
@@ -0,0 +1,44 @@
|
|||||||
|
# SGU Credential Provider 0.6.3
|
||||||
|
|
||||||
|
Corrige el primer inicio de sesión de perfiles completos `AD`/`DO` cuando Azure
|
||||||
|
Files se consume mediante su endpoint público.
|
||||||
|
|
||||||
|
## Cambios
|
||||||
|
|
||||||
|
- `Enable-SguAzureUserRoaming.ps1` selecciona automáticamente FSLogix Cloud
|
||||||
|
Cache para endpoints públicos y conserva el montaje directo para endpoints
|
||||||
|
privados.
|
||||||
|
- Cloud Cache realiza el I/O del perfil sobre el VHDX local y sincroniza con
|
||||||
|
Azure Files, evitando que la latencia WAN de SMB bloquee cada operación.
|
||||||
|
- La GPO elimina de forma efectiva `VHDLocations` al activar `CCDLocations`,
|
||||||
|
incluyendo equipos que habían aplicado la política directa anterior.
|
||||||
|
- Se impide el retorno silencioso a un perfil local o temporal cuando FSLogix
|
||||||
|
no puede registrar el contenedor.
|
||||||
|
- El cierre de sesión deja de esperar indefinidamente por un proveedor remoto:
|
||||||
|
se limita a 60 segundos y conserva la caché local si vence el plazo.
|
||||||
|
- La documentación agrega capacidad de disco, validación del registro efectivo
|
||||||
|
y rutas de diagnóstico para ambos modos.
|
||||||
|
|
||||||
|
## Validación del despliegue
|
||||||
|
|
||||||
|
- Se eliminó únicamente el perfil piloto fallido de `AD017045` en `AF-03`; la
|
||||||
|
cuenta de Active Directory se conservó.
|
||||||
|
- La GPO `SGU - AD-DO FSLogix profiles` quedó en Cloud Cache para los SID de
|
||||||
|
`SGU-Administrativos` y `SGU-Docentes`; `VHDLocations` ya no aparece en el
|
||||||
|
registro efectivo de `AF-03`.
|
||||||
|
- El nuevo inicio de `AD017045` creó la caché y el proxy locales, agregó la
|
||||||
|
redirección del perfil al VHDX y completó `LoadProfile` en 4.649 segundos, sin
|
||||||
|
error 258, perfil temporal ni retorno local.
|
||||||
|
- Pasaron 70 pruebas Pester, 41 pruebas de `SGU.AuthBroker.Core`, 16 de
|
||||||
|
`SGU.AuthBroker` y 6 del Credential Provider. La solución compiló sin errores.
|
||||||
|
|
||||||
|
## Descargas
|
||||||
|
|
||||||
|
- `sgu-windows-client-bootstrap-0.6.3.zip`
|
||||||
|
- `sgu-server-bootstrap-0.6.3.zip`
|
||||||
|
- `sgu-linux-client-bootstrap-0.6.3.zip`
|
||||||
|
- `sgu-azure-infrastructure-0.6.3.zip`
|
||||||
|
- `SHA256SUMS-0.6.3.txt`
|
||||||
|
|
||||||
|
Verifique los hashes SHA-256 antes de ejecutar los paquetes. No se incluyen
|
||||||
|
credenciales, claves de almacenamiento ni artefactos temporales del despliegue.
|
||||||
@@ -0,0 +1,27 @@
|
|||||||
|
# SGU Credential Provider 0.6.4
|
||||||
|
|
||||||
|
Esta versión revierte el despliegue de perfiles móviles y deja los perfiles
|
||||||
|
locales como comportamiento predeterminado para todo el dominio SGU.
|
||||||
|
|
||||||
|
## Cambio operativo
|
||||||
|
|
||||||
|
- `AL`, `AD`, `DO` y cualquier otra cuenta usan un perfil local bajo `C:\Users`.
|
||||||
|
- Escritorio y Documentos vuelven a las rutas locales del usuario.
|
||||||
|
- No se configura `profilePath`, `homeDirectory` ni `homeDrive` en Active Directory.
|
||||||
|
- Las políticas deshabilitan FSLogix Profiles, ODFC, `frxsvc` y `frxccds`.
|
||||||
|
- El enlace de instalación automática de FSLogix queda deshabilitado.
|
||||||
|
- Los recursos Azure Files existentes no se destruyen y pueden conservarse para
|
||||||
|
recuperación o para un piloto futuro.
|
||||||
|
|
||||||
|
## Herramientas
|
||||||
|
|
||||||
|
`Disable-SguAzureUserRoaming.ps1` aplica el rollback idempotente en el dominio.
|
||||||
|
`Deploy-SguAzureInfrastructure.ps1` y Bicep usan
|
||||||
|
`DeployUserRoaming=false` por omisión. Tanto el aprovisionamiento como la
|
||||||
|
publicación de políticas exigen `AcknowledgeUserRoamingRisks` para volver a
|
||||||
|
activar la función opcional.
|
||||||
|
|
||||||
|
La documentación registra los tiempos prolongados de inicio/cierre, estados
|
||||||
|
pendientes de VHDX, caché obsoleta y recuperación mediante reinicio observados
|
||||||
|
durante el piloto. User roaming se considera experimental y nunca se habilita de
|
||||||
|
forma implícita.
|
||||||
@@ -0,0 +1,26 @@
|
|||||||
|
# SGU Credential Provider 0.6.5
|
||||||
|
|
||||||
|
Esta versión actualiza los fondos de bienvenida de Windows y Linux sin agregar
|
||||||
|
dependencias ni trabajo de composición durante el inicio de sesión.
|
||||||
|
|
||||||
|
## Identidad visual
|
||||||
|
|
||||||
|
- El fondo base azul incorpora de forma permanente el logotipo blanco oficial
|
||||||
|
de Universidad La Salle México.
|
||||||
|
- El generador utiliza directamente ese JPEG: no abre, redimensiona ni compone
|
||||||
|
un segundo archivo de logotipo cada vez que inicia una sesión.
|
||||||
|
- Se conservan las dimensiones institucionales de `1600x1000` y el área central
|
||||||
|
disponible para el saludo personalizado.
|
||||||
|
|
||||||
|
## Texto de ubicación
|
||||||
|
|
||||||
|
- La sala aparece en una primera línea de mayor tamaño.
|
||||||
|
- La dependencia aparece debajo con una tipografía menor.
|
||||||
|
- La redacción neutral usa `Acceso a...`; cuando Active Directory contiene el
|
||||||
|
sexo enriquecido, usa `Estás ubicado...` o `Estás ubicada...`.
|
||||||
|
- La misma lógica está incluida en los enrolamientos de Windows y Linux.
|
||||||
|
- Si faltan el sexo o los metadatos de ubicación, permanecen los fallbacks
|
||||||
|
neutrales documentados y el inicio de sesión no se bloquea.
|
||||||
|
|
||||||
|
Los perfiles de usuario locales y el rollback de roaming introducido en 0.6.4
|
||||||
|
no cambian en esta versión.
|
||||||
@@ -0,0 +1,16 @@
|
|||||||
|
# SGU Credential Provider 0.6.6
|
||||||
|
|
||||||
|
Esta versión ajusta la composición del fondo institucional introducido en
|
||||||
|
0.6.5.
|
||||||
|
|
||||||
|
- El logotipo blanco oficial de Universidad La Salle México queda integrado en
|
||||||
|
la esquina inferior derecha.
|
||||||
|
- Su tamaño se reduce ligeramente y se conserva un margen interior respecto de
|
||||||
|
ambos bordes para acercarlo visualmente al centro.
|
||||||
|
- El fondo original de `1600x1000`, el área central del saludo y la composición
|
||||||
|
dinámica de nombre y ubicación permanecen sin cambios.
|
||||||
|
- El generador sigue sin cargar ni componer un logotipo durante el inicio de
|
||||||
|
sesión.
|
||||||
|
|
||||||
|
No se modifican la autenticación, el enrolamiento, las políticas del dominio ni
|
||||||
|
el comportamiento de perfiles locales establecido en 0.6.4.
|
||||||
@@ -0,0 +1,17 @@
|
|||||||
|
# SGU Credential Provider 0.6.7
|
||||||
|
|
||||||
|
Esta versión separa la imagen de la pantalla de bloqueo de la base utilizada
|
||||||
|
para generar el escritorio personalizado.
|
||||||
|
|
||||||
|
- `darkblue-lockscreen.jpg` contiene únicamente el fondo azul institucional,
|
||||||
|
sin logotipo ni datos personales.
|
||||||
|
- `darkblue.jpg` continúa como base del escritorio de cada sesión y conserva el
|
||||||
|
logotipo oficial integrado.
|
||||||
|
- El logo de escritorio se reduce nuevamente y se desplaza ligeramente hacia
|
||||||
|
arriba, sin interferir con el saludo central.
|
||||||
|
- El instalador, la GPO clásica, `PersonalizationCSP` y los paquetes de servidor
|
||||||
|
y cliente utilizan explícitamente el archivo correspondiente a cada función.
|
||||||
|
- Linux continúa usando sólo la base de escritorio personalizada.
|
||||||
|
|
||||||
|
No se modifican la autenticación, los perfiles locales ni las reglas de
|
||||||
|
enrolamiento.
|
||||||
@@ -0,0 +1,17 @@
|
|||||||
|
# SGU Credential Provider 0.6.8
|
||||||
|
|
||||||
|
Esta versión declara al Auth Broker como la única autoridad de contraseñas para
|
||||||
|
todas las cuentas administradas bajo `OU=Usuarios-SGU`.
|
||||||
|
|
||||||
|
- Cada creación, movimiento o actualización de una cuenta agrega de forma
|
||||||
|
idempotente las denegaciones SELF y Everyone para el derecho extendido de
|
||||||
|
Active Directory `Change Password`.
|
||||||
|
- El usuario no puede cambiar la contraseña desde Windows, Ctrl+Alt+Delete,
|
||||||
|
LDAP ni herramientas equivalentes.
|
||||||
|
- El broker conserva el derecho administrativo separado `Reset Password` y
|
||||||
|
continúa sincronizando la contraseña institucional exacta mediante
|
||||||
|
`SetPassword` después de una autenticación SGU válida.
|
||||||
|
- El despliegue del broker recorre todas las cuentas existentes en
|
||||||
|
`Usuarios-SGU` y corrige aquellas que todavía permiten cambios directos.
|
||||||
|
|
||||||
|
No se modifica la contraseña institucional ni se almacena una copia adicional.
|
||||||
@@ -0,0 +1,16 @@
|
|||||||
|
# SGU Credential Provider 0.6.9
|
||||||
|
|
||||||
|
Esta versión completa la autoridad de contraseñas del Auth Broker en la
|
||||||
|
interfaz de Windows.
|
||||||
|
|
||||||
|
- La GPO `SGU - User session restrictions` habilita la directiva **Remove
|
||||||
|
Change Password** para todas las cuentas bajo `OU=Usuarios-SGU`.
|
||||||
|
- La opción **Cambiar una contraseña** deja de aparecer en la pantalla de
|
||||||
|
seguridad de Ctrl+Alt+Supr.
|
||||||
|
- La protección real continúa en Active Directory mediante las denegaciones
|
||||||
|
del derecho extendido `Change Password`; la GPO únicamente evita mostrar una
|
||||||
|
acción que esas cuentas no pueden completar.
|
||||||
|
|
||||||
|
El Auth Broker conserva el derecho administrativo separado `Reset Password`
|
||||||
|
para sincronizar la contraseña institucional después de una autenticación SGU
|
||||||
|
válida.
|
||||||
@@ -0,0 +1,97 @@
|
|||||||
|
# RustDesk autoalojado y acceso remoto administrado
|
||||||
|
|
||||||
|
El bootstrap del controlador de dominio instala un servidor RustDesk OSS
|
||||||
|
autoalojado y el bootstrap de cada cliente Windows inscrito instala el agente
|
||||||
|
RustDesk administrado. Esto permite administrar el propio controlador y cada
|
||||||
|
cliente del laboratorio sin depender de los servidores públicos de RustDesk.
|
||||||
|
|
||||||
|
## Componentes y red
|
||||||
|
|
||||||
|
El controlador inicia ambos componentes bajo `SYSTEM` mediante las tareas
|
||||||
|
programadas `SGU-RustDesk-hbbs` y `SGU-RustDesk-hbbr`:
|
||||||
|
|
||||||
|
| Componente | Función | Puerto entrante |
|
||||||
|
| --- | --- | --- |
|
||||||
|
| `hbbs` | ID/rendezvous y prueba NAT | TCP 21115-21116 y UDP 21116 |
|
||||||
|
| `hbbr` | Relay para sesiones que no pueden ser directas | TCP 21117 |
|
||||||
|
|
||||||
|
Las reglas se llaman **SGU RustDesk** y sólo aceptan la subred privada que se
|
||||||
|
indicó al bootstrap del servidor. No se habilitan el servidor web ni los puertos
|
||||||
|
21118/21119. Los clientes y el servidor necesitan salida HTTPS a GitHub sólo
|
||||||
|
durante una primera instalación o actualización, para descargar el binario
|
||||||
|
verificado por SHA-256.
|
||||||
|
|
||||||
|
El nombre interno usado por los clientes es `rustdesk.lci.lasalle.mx`; el
|
||||||
|
bootstrap del DC mantiene su registro A en DNS apuntando a la IP fija del
|
||||||
|
controlador.
|
||||||
|
|
||||||
|
## Alta automática de un equipo Windows
|
||||||
|
|
||||||
|
Al finalizar `Invoke-SguClientBootstrap.ps1`, antes de considerar válido el
|
||||||
|
enrolamiento, el flujo:
|
||||||
|
|
||||||
|
1. lee la clave pública del servidor a través de la sesión autenticada con el
|
||||||
|
DC;
|
||||||
|
2. instala RustDesk desde el MSI oficial, comprobando el SHA-256 fijado;
|
||||||
|
3. instala y arranca el servicio `RustDesk` como automático;
|
||||||
|
4. configura ID, relay y clave pública del servidor privado en el contexto del
|
||||||
|
servicio y para perfiles nuevos;
|
||||||
|
5. crea una contraseña única de acceso desatendido, cifrada con DPAPI local y
|
||||||
|
protegida por ACL para `SYSTEM` y administradores locales;
|
||||||
|
6. registra únicamente el ID y la contraseña cifrada en el inventario del DC.
|
||||||
|
|
||||||
|
La contraseña no se imprime, no se pone en el manifiesto y no se añade a los
|
||||||
|
logs. El inventario del servidor usa DPAPI de la máquina y está limitado por ACL
|
||||||
|
a `SYSTEM` y administradores del servidor.
|
||||||
|
|
||||||
|
El mismo flujo se aplica al DC, por lo que también se puede administrar de forma
|
||||||
|
remota. Reejecutar el bootstrap mantiene el ID y la contraseña existentes, y
|
||||||
|
vuelve a validar configuración, tareas, servicio y conectividad sin crear otro
|
||||||
|
registro.
|
||||||
|
|
||||||
|
## Verificación y operación
|
||||||
|
|
||||||
|
En el DC, como administrador:
|
||||||
|
|
||||||
|
```powershell
|
||||||
|
Get-ScheduledTask SGU-RustDesk-hbbs,SGU-RustDesk-hbbr |
|
||||||
|
Select-Object TaskName,State
|
||||||
|
Get-NetTCPConnection -State Listen -LocalPort 21116,21117
|
||||||
|
Get-Content C:\ProgramData\SGU\RustDesk\server.json
|
||||||
|
& C:\ProgramData\SGU\RustDesk\Get-SguRustDeskDevice.ps1
|
||||||
|
```
|
||||||
|
|
||||||
|
El último comando muestra los nombres, IDs y fecha de alta, sin contraseñas. Si
|
||||||
|
un administrador necesita recuperar una contraseña para conectarse desde el
|
||||||
|
cliente controlador de RustDesk, puede hacerlo explícitamente en la consola del
|
||||||
|
DC:
|
||||||
|
|
||||||
|
```powershell
|
||||||
|
& C:\ProgramData\SGU\RustDesk\Get-SguRustDeskDevice.ps1 `
|
||||||
|
-ComputerName LCI-01 -RevealPassword
|
||||||
|
```
|
||||||
|
|
||||||
|
Trata esa salida como una credencial administrativa: no la pegues en tickets,
|
||||||
|
capturas ni registros. En RustDesk, conecta usando el ID inventariado y el modo
|
||||||
|
de autenticación por contraseña permanente.
|
||||||
|
|
||||||
|
En un cliente, los indicadores locales son:
|
||||||
|
|
||||||
|
```powershell
|
||||||
|
Get-Service RustDesk
|
||||||
|
Get-Content C:\ProgramData\SGU\RustDesk\Client\device.json
|
||||||
|
Test-NetConnection rustdesk.lci.lasalle.mx -Port 21116
|
||||||
|
```
|
||||||
|
|
||||||
|
Si un agente deja de funcionar, se puede repetir el bootstrap del cliente. El
|
||||||
|
guardián de enrolamiento también repara la configuración de RustDesk al inicio
|
||||||
|
cuando la información del servidor sigue presente en su estado de enrolamiento.
|
||||||
|
|
||||||
|
## Límites operativos
|
||||||
|
|
||||||
|
Este alcance automatiza el cliente Windows entregado por
|
||||||
|
`Invoke-SguClientBootstrap.ps1`. El bootstrap Linux conserva su inicio PAM/SSSD
|
||||||
|
independiente y usa un flujo propio de inventario: autentica con la cuenta de
|
||||||
|
equipo Kerberos, cifra la contraseña de RustDesk para el controlador y recibe
|
||||||
|
su confirmación desde la cola protegida. No reutiliza ni expone contraseñas de
|
||||||
|
Windows.
|
||||||
+68
-18
@@ -1,5 +1,14 @@
|
|||||||
# Security model
|
# Security model
|
||||||
|
|
||||||
|
## Public Azure deployment
|
||||||
|
|
||||||
|
The Azure topology supports certificate-authenticated P2S or direct enrollment.
|
||||||
|
P2S keeps AD services inside the VNet. Direct enrollment exposes the required
|
||||||
|
AD, DNS/DoH, WinRM, broker and RustDesk ports only to explicit public IPv4 CIDRs;
|
||||||
|
an empty allowlist exposes none of them. Azure NSG and Windows Firewall enforce
|
||||||
|
the same source list. RDP uses a separate allowlist. See
|
||||||
|
[azure-vpn-deployment.md](azure-vpn-deployment.md).
|
||||||
|
|
||||||
## Password handling
|
## Password handling
|
||||||
|
|
||||||
- The Credential Provider receives the password in Lithnet's secure password
|
- The Credential Provider receives the password in Lithnet's secure password
|
||||||
@@ -9,6 +18,26 @@
|
|||||||
`Marshal.ZeroFreeGlobalAllocUnicode`; managed references are released as soon
|
`Marshal.ZeroFreeGlobalAllocUnicode`; managed references are released as soon
|
||||||
as each request completes.
|
as each request completes.
|
||||||
- The broker uses the exact received value for both NTLM and AD `SetPassword`.
|
- The broker uses the exact received value for both NTLM and AD `SetPassword`.
|
||||||
|
- The `SGU - Institutional password authority` fine-grained AD password policy
|
||||||
|
applies only to the global security groups `SGU-Alumnos`,
|
||||||
|
`SGU-Administrativos`, and `SGU-Docentes`. It disables AD complexity,
|
||||||
|
history, and password age requirements and permits passwords from one
|
||||||
|
character onward so passwords accepted by SGU can be recorded unchanged by AD.
|
||||||
|
Reversible storage is disabled in this fine-grained policy and in each SGU
|
||||||
|
account. The default domain password policy remains unchanged for non-SGU
|
||||||
|
accounts. Bootstrap repairs existing role-group members, and the broker clears
|
||||||
|
the per-user reversible-storage flag before every `SetPassword`.
|
||||||
|
- Disabling reversible storage does not rewrite password data already stored in
|
||||||
|
reversible form. Those existing values remain until each password is reset;
|
||||||
|
the broker synchronizes the current SGU password on the next successful
|
||||||
|
Acceso SGU sign-in, at which point AD stores it without reversible encryption.
|
||||||
|
- Managed `Usuarios-SGU` accounts deny the SELF and Everyone `Change Password`
|
||||||
|
extended right. Only an administrator or the broker through the separate
|
||||||
|
`Reset Password` right can replace the AD password.
|
||||||
|
- The `SGU - User session restrictions` GPO also hides the **Change a
|
||||||
|
password** command from the Windows Ctrl+Alt+Delete security screen for
|
||||||
|
managed users. This is a user-interface complement to the directory ACL,
|
||||||
|
not a substitute for it.
|
||||||
- There is no HMAC password, pepper, local password cache, Supabase password, or
|
- There is no HMAC password, pepper, local password cache, Supabase password, or
|
||||||
other derived credential in this Windows path.
|
other derived credential in this Windows path.
|
||||||
- Neither application logs request bodies or passwords. Deployment configuration
|
- Neither application logs request bodies or passwords. Deployment configuration
|
||||||
@@ -33,26 +62,33 @@
|
|||||||
- Administrative enrichment first verifies the employee number and reads
|
- Administrative enrichment first verifies the employee number and reads
|
||||||
employee type/status, email, job title, and department from the incident
|
employee type/status, email, job title, and department from the incident
|
||||||
overview. Only after that match, it reads given names and paternal/maternal
|
overview. Only after that match, it reads given names and paternal/maternal
|
||||||
surnames from the personal page plus street, exterior/interior number,
|
surnames and the normalized `Male`/`Female` value from the personal page plus
|
||||||
neighborhood, locality, state, and postal code from the location page.
|
street, exterior/interior number, neighborhood, locality, state, and postal
|
||||||
- Administrative birth date, RFC, CURP, sex, blood type, marital status,
|
code from the location page. AD stores only the controlled `SGU-Gender` line,
|
||||||
|
not the original HTML field.
|
||||||
|
- Administrative birth date, RFC, CURP, blood type, marital status,
|
||||||
nationality, telephone, email lists, housing type, and emergency-contact
|
nationality, telephone, email lists, housing type, and emergency-contact
|
||||||
fields are ignored.
|
fields are ignored.
|
||||||
- Student enrichment reads only the matching student number, given names,
|
- Student enrichment reads only the matching student number, given names,
|
||||||
paternal/maternal surnames, email, career, street, neighborhood,
|
paternal/maternal surnames, email, career, street, neighborhood,
|
||||||
city/municipality, state, and postal code from known element IDs.
|
city/municipality, state, postal code, and normalized sex from known element
|
||||||
- Student CURP, birth date, sex, blood type, marital status, telephone, mobile,
|
IDs.
|
||||||
|
- Student CURP, birth date, blood type, marital status, telephone, mobile,
|
||||||
guardian, medical, financial, and academic-history values are ignored.
|
guardian, medical, financial, and academic-history values are ignored.
|
||||||
- Professor enrichment keeps the menu display name as its base and optionally
|
- Professor enrichment keeps the menu display name as its base. From the payroll
|
||||||
reads only the same name and postal-address element IDs used by staff pages.
|
consultation header it reads only a matching employee number, name, email,
|
||||||
A missing professor route or element never makes authentication fail.
|
employee type/status, job title, and the optional department field. It then
|
||||||
- Incident details, calendars, photographs, manager names, and manager positions
|
optionally reads the same structured-name and postal-address element IDs used
|
||||||
are deliberately ignored.
|
by staff pages. A missing professor route or element never makes authentication
|
||||||
|
fail.
|
||||||
|
- Payroll/receipt contents, incident details, calendars, photographs, manager
|
||||||
|
names, and manager positions are deliberately ignored.
|
||||||
- The employee or student number must match the authenticated `AD` or `AL` key
|
- The employee or student number must match the authenticated `AD` or `AL` key
|
||||||
before role-specific metadata is synchronized. The two supplemental
|
before role-specific metadata is synchronized. The two supplemental
|
||||||
administrative pages are never requested unless the incident page supplied
|
administrative pages are never requested unless the incident page supplied
|
||||||
the matching employee number. Professor supplemental data comes from the
|
the matching employee number. Professor payroll metadata independently
|
||||||
same fresh, request-scoped NTLM session as its menu fallback.
|
requires the matching six-digit number, and every supplemental request uses
|
||||||
|
the same fresh, request-scoped NTLM session as its menu fallback.
|
||||||
- If SGU changes its HTML, authentication and exact-password synchronization
|
- If SGU changes its HTML, authentication and exact-password synchronization
|
||||||
continue without enrichment; existing AD metadata is not erased.
|
continue without enrichment; existing AD metadata is not erased.
|
||||||
- Slow profile pages cannot change an accepted credential into a rejection. The
|
- Slow profile pages cannot change an accepted credential into a rejection. The
|
||||||
@@ -64,13 +100,27 @@ Use an enterprise CA with revocation checking in production.
|
|||||||
|
|
||||||
## Recovery and availability
|
## Recovery and availability
|
||||||
|
|
||||||
The provider distinguishes an authoritative rejection from unavailable
|
The provider distinguishes an SGU rejection from unavailable infrastructure:
|
||||||
infrastructure:
|
|
||||||
|
|
||||||
- `400`/`401`: fail closed and show an error.
|
- `400`/`401`: do not create or update the account and do not submit a Windows
|
||||||
- timeout, TLS/connectivity error, `429`, or `5xx`: submit the unchanged credential
|
credential. An explicit SGU rejection is authoritative, including when an
|
||||||
to Windows. Windows must still validate it against AD or the cached domain
|
older AD password still exists.
|
||||||
verifier, so this does not grant access without the last synchronized password.
|
- `DIRECTORY_SYNCHRONIZATION_FAILED`: SGU accepted the password but AD did not
|
||||||
|
record it. Show a specific error and do not attempt Windows logon against a
|
||||||
|
potentially stale AD verifier.
|
||||||
|
- timeout, TLS/connectivity error, `429`, or `5xx`: submit the unchanged
|
||||||
|
credential to Windows only for a genuine broker/SGU outage. Windows must still
|
||||||
|
validate it against AD or its cached domain verifier, so this does not grant
|
||||||
|
access without a domain credential. This continuity path can accept a
|
||||||
|
last-known AD password while SGU is unreachable; decide explicitly whether
|
||||||
|
that availability trade-off is appropriate for each deployment.
|
||||||
|
- usernames that do not match the institutional key format go directly to
|
||||||
|
Windows and are never sent to SGU or provisioned by the broker.
|
||||||
|
|
||||||
|
Allowing an SGU-accepted three-character password also allows that short
|
||||||
|
password at the native AD logon surface. Broker rate limiting does not protect
|
||||||
|
direct AD authentication; domain network exposure and monitoring therefore
|
||||||
|
remain essential. The policy cannot make a weak upstream password strong.
|
||||||
|
|
||||||
Redis is deliberately not used for password continuity. A second persistent
|
Redis is deliberately not used for password continuity. A second persistent
|
||||||
password verifier duplicates attackable credential material, while a reversible
|
password verifier duplicates attackable credential material, while a reversible
|
||||||
|
|||||||
@@ -0,0 +1,171 @@
|
|||||||
|
# Validación del bootstrap Windows unificado
|
||||||
|
|
||||||
|
Fecha: 2026-09-10. Paquete: 0.5.1.
|
||||||
|
|
||||||
|
## Comprobaciones locales
|
||||||
|
|
||||||
|
- Publicación Release del Auth Broker y del Credential Provider completada.
|
||||||
|
- Pruebas Pester ejecutadas en Windows PowerShell 5.1: selección de rutas,
|
||||||
|
dos interfaces, VPN en otra subred, preferencia por la ruta de Windows,
|
||||||
|
restricción explícita de interfaz, APIPA, falta de ruta, prefijo más específico,
|
||||||
|
ruta de host y conflictos, DNS limitado al dominio, reintentos y compatibilidad.
|
||||||
|
- Prueba TCP real con socket ligado a una IP e interfaz y servicio cerrado.
|
||||||
|
- Reenrolamiento: se conserva la contraseña de `alumno` si la cuenta ya existe,
|
||||||
|
para no provocar rechazos de historial/complejidad tras aplicar las políticas
|
||||||
|
del dominio; se mantienen las verificaciones de permisos de usuario estándar.
|
||||||
|
- El empaquetador genera un solo ZIP Windows con los lanzadores habitual y Azure,
|
||||||
|
el instalador VPN, el runtime offline y el manifiesto SHA-256.
|
||||||
|
|
||||||
|
## Prueba real en Hyper-V: Windows 11
|
||||||
|
|
||||||
|
Servidor: VM `Windows Server`, dominio `lci.lasalle.mx`, DC `192.168.50.10`.
|
||||||
|
Cliente: VM `Windows11-002`, Windows 11 Enterprise LTSC, build 26100,
|
||||||
|
nombre de equipo `DESKTOP-LM7D7OM`, inicialmente en WORKGROUP.
|
||||||
|
|
||||||
|
Antes de la prueba se creó el checkpoint
|
||||||
|
`Before SGU unified enrollment 2026-09-10`. El cliente sólo tenía conexión al
|
||||||
|
`Default Switch`; se añadió la tarjeta `SGU AD Test` al switch `Laboratorio AD`
|
||||||
|
y se configuró administrativamente `192.168.50.202/24` sin puerta de enlace.
|
||||||
|
Esta preparación de la red del laboratorio es independiente del bootstrap:
|
||||||
|
el enrolador no asignó esa dirección y no recibió parámetros de IP del cliente,
|
||||||
|
interfaz, dominio, NetBIOS ni OU.
|
||||||
|
|
||||||
|
Se ejecutó el paquete con la IP del DC, una credencial en memoria y
|
||||||
|
`-SkipRestart` para inspeccionar el resultado; después se reinició el cliente.
|
||||||
|
|
||||||
|
Resultados comprobados:
|
||||||
|
|
||||||
|
- Selección automática de `Laboratorio AD` y descubrimiento autenticado de
|
||||||
|
`lci.lasalle.mx`, `LCI` y `OU=Laboratorio`.
|
||||||
|
- Proveedor y certificados instalados; salud mTLS verificada antes de la unión.
|
||||||
|
- Unión al dominio completada y `Test-ComputerSecureChannel` verdadero después
|
||||||
|
del reinicio.
|
||||||
|
- `Test-SguClientEnrollment.ps1` con exigencia de dominio, broker, acceso remoto
|
||||||
|
y RustDesk: `IsValid=True`, sin incidencias, después del guard de arranque.
|
||||||
|
- Interfaz privada `DomainAuthenticated`; interfaz de Internet `Public`, con
|
||||||
|
DHCP y su servidor DNS originales. Resolución pública y HTTPS comprobados
|
||||||
|
contra `www.microsoft.com` (HTTP 200).
|
||||||
|
|
||||||
|
## Prueba real en Hyper-V: Windows 10
|
||||||
|
|
||||||
|
Fecha: 2026-09-10. Cliente: VM `Windows10-001`, Windows 10 Enterprise LTSC
|
||||||
|
x64, build 19044, nombre de equipo `DESKTOP-HDKRD5V`, inicialmente en WORKGROUP.
|
||||||
|
Se usó el mismo ZIP 0.5.1 publicado en Gitea, sin modificar sus scripts ni
|
||||||
|
binarios. SHA-256 del ZIP:
|
||||||
|
|
||||||
|
```text
|
||||||
|
4DBE45697D74110F65C6D7825A593121B19C53B5F286F0DBC00068F3AFE45FB0
|
||||||
|
```
|
||||||
|
|
||||||
|
Se guardó el checkpoint `Before SGU Windows10 validation 2026-09-10`.
|
||||||
|
La VM ya tenía dos tarjetas: `Ethernet` en `Default Switch`, con DHCP y DNS
|
||||||
|
`172.18.176.1`, y `Ethernet 2` en `Laboratorio AD`, con dirección APIPA.
|
||||||
|
|
||||||
|
Primero se ejecutó el bootstrap sin preparar la IP privada. Reintentó la
|
||||||
|
conexión, diagnosticó que `Ethernet 2` no tenía una IPv4 utilizable y que la ruta
|
||||||
|
de Internet no alcanzaba WinRM del servidor. No solicitó una IP del cliente,
|
||||||
|
no modificó sus direcciones y mantuvo el equipo en WORKGROUP.
|
||||||
|
|
||||||
|
Para la prueba positiva se configuró administrativamente
|
||||||
|
`192.168.50.203/24` en `Ethernet 2`, sin puerta de enlace, y se esperó a que
|
||||||
|
Windows confirmara la dirección como `Preferred`. Esta preparación corresponde
|
||||||
|
a la red de laboratorio sin DHCP; no la realizó el bootstrap. Se ejecutó de
|
||||||
|
nuevo el ZIP con sólo la IP del DC, una credencial en memoria y `-SkipRestart`,
|
||||||
|
sin parámetros de interfaz, IP del cliente, dominio, NetBIOS ni OU.
|
||||||
|
|
||||||
|
Resultados:
|
||||||
|
|
||||||
|
- Selección automática de `Ethernet 2`, descubrimiento de `lci.lasalle.mx`,
|
||||||
|
`LCI` y `OU=Laboratorio`, y unión al dominio completada.
|
||||||
|
- Proveedor y certificados instalados; proveedor validado antes de la unión.
|
||||||
|
- Tras reiniciar, `Test-ComputerSecureChannel=True` y tarea
|
||||||
|
`SGU-CredentialProvider-EnrollmentGuard` finalizada con `LastTaskResult=0`.
|
||||||
|
- Validación con dominio, salud del broker, acceso remoto y RustDesk exigidos:
|
||||||
|
`IsValid=True`, `Issues={}`, `BrokerHealth=ok`, `RemoteAccessReady=True` y
|
||||||
|
`RustDeskReady=True`.
|
||||||
|
- Runtime .NET y binarios presentes; proveedor de contraseña de Windows
|
||||||
|
conservado. Cuenta `alumno` presente, sin permisos de administrador y con
|
||||||
|
expiración de contraseña deshabilitada.
|
||||||
|
- `Ethernet 2` quedó como `DomainAuthenticated`; `Ethernet` permaneció como
|
||||||
|
`Public`, conservando su DHCP y DNS original. HTTPS hacia
|
||||||
|
`https://www.microsoft.com` respondió HTTP 200.
|
||||||
|
|
||||||
|
No fue necesario corregir el bootstrap para esta prueba. La VM quedó encendida
|
||||||
|
y enrolada, con el ZIP extraído en sus Descargas y el checkpoint previo disponible.
|
||||||
|
|
||||||
|
### Comprobación posterior del escritorio
|
||||||
|
|
||||||
|
La validación anterior comprobaba el enrolamiento, pero no el fondo visible
|
||||||
|
en una sesión de usuario. Al revisar la sesión de `Windows10-001`, el fondo
|
||||||
|
seguía siendo el predeterminado de Windows. El registro del generador mostró
|
||||||
|
un fallo de validación al asignar el género vacío devuelto por AD al parámetro
|
||||||
|
`Gender`, cuyo `ValidateSet` sólo permite `Male` o `Female`.
|
||||||
|
|
||||||
|
Se corrigió `Set-SguWelcomeWallpaper.ps1` para mantener el saludo neutral cuando
|
||||||
|
el dato no está disponible. Se actualizaron el generador instalado y su copia
|
||||||
|
en el paquete de autorreparación, y se ejecutó en el contexto de la sesión
|
||||||
|
interactiva existente, sin cerrar sesión ni solicitar otra contraseña.
|
||||||
|
El registro terminó con `OK`, la configuración del usuario apuntó al JPEG
|
||||||
|
generado y se verificó visualmente el fondo institucional con nombre y saludo.
|
||||||
|
La tarea temporal utilizada para actualizar la sesión se retiró al finalizar;
|
||||||
|
la ejecución habitual al iniciar sesión sigue a cargo de la GPO.
|
||||||
|
|
||||||
|
Se agregaron cuatro pruebas de renderizado JPEG: género ausente, vacío o
|
||||||
|
desconocido, valores reconocidos y prioridad de un valor explícito. Todas
|
||||||
|
pasaron en Windows PowerShell 5.1. Esta corrección posterior está en el código
|
||||||
|
y en la VM; el ZIP publicado como 0.5.1 no se modificó.
|
||||||
|
|
||||||
|
## Prueba real de enrolamiento público directo: Windows 10
|
||||||
|
|
||||||
|
Fecha: 2026-09-11. Se repitió el enrolamiento de `Windows10-001` contra el DC
|
||||||
|
Azure `20.9.81.130`, sin perfil ni interfaz VPN. El cliente conservó sus dos NIC
|
||||||
|
y seleccionó por sí solo `Ethernet` con DHCP (`172.18.183.201`), porque era la
|
||||||
|
ruta que alcanzaba WinRM. El segmento público de salida autorizado fue
|
||||||
|
`200.13.89.0/24`.
|
||||||
|
|
||||||
|
La VM aún nombraba `lci.lasalle.mx`, pero su canal seguro pertenecía al bosque
|
||||||
|
anterior y estaba roto. El flujo creó o reutilizó la cuenta de equipo en la OU
|
||||||
|
descubierta, restableció la contraseña de máquina contra
|
||||||
|
`SGU-DC01.lci.lasalle.mx`, reinició Netlogon y conservó el equipo unido. También
|
||||||
|
toleró SID huérfanos del bosque anterior al comprobar los grupos locales.
|
||||||
|
|
||||||
|
Windows 10 Enterprise LTSC build 19044 no expone los cmdlets DoH. El bootstrap
|
||||||
|
lo detectó y usó DNS tradicional hacia la misma IP pública, limitado por NSG y
|
||||||
|
Windows Firewall al CIDR permitido. Después de un reinicio real se comprobó:
|
||||||
|
|
||||||
|
- `Test-ComputerSecureChannel=True` y resolución SRV del DC;
|
||||||
|
- `IsValid=True`, sin incidencias;
|
||||||
|
- `BrokerHealth=ok`, `RemoteAccessReady=True` y `RustDeskReady=True`;
|
||||||
|
- ningún perfil VPN instalado;
|
||||||
|
- paquete candidato usado en la prueba `0.5.9`, SHA-256 del ZIP de Windows:
|
||||||
|
`E7AF77252E444FB7EBACF3C90005D322EE19F76DD9387AC5782C57EA9EE617B7`.
|
||||||
|
|
||||||
|
## Prueba real con Azure VPN
|
||||||
|
|
||||||
|
El 2026-09-10 se desplegó `sgu-lab-dc` en Azure Central US, se creó el bosque
|
||||||
|
`lci.lasalle.mx` y se enroló `Windows11-002` mediante un gateway real
|
||||||
|
`VpnGw1AZ`. El controlador tiene IP `10.77.0.4` y el cliente obtuvo
|
||||||
|
`172.30.0.2` por IKEv2 con certificado de máquina. El bootstrap descubrió
|
||||||
|
automáticamente la interfaz VPN, el dominio y la OU a partir de la IP del DC
|
||||||
|
y la credencial administrativa.
|
||||||
|
|
||||||
|
Se comprobaron el objeto de equipo en `OU=Laboratorio`, el canal seguro y la
|
||||||
|
validación SGU completa, incluyendo salud mTLS, acceso remoto y RustDesk.
|
||||||
|
Para Enterprise se configuró un device tunnel y una recuperación de Netlogon
|
||||||
|
para la conectividad tardía al arrancar. El bosque Azure es independiente del
|
||||||
|
bosque local con el mismo nombre.
|
||||||
|
|
||||||
|
La infraestructura, versiones de paquetes, ajustes adicionales y evidencias
|
||||||
|
están en [el informe de Azure](azure-deployment-validation-2026-09-10.md).
|
||||||
|
Se usaron paquetes locales de validación `0.5.2-azure.*`; el release publicado
|
||||||
|
0.5.1 no se reemplazó durante este despliegue.
|
||||||
|
|
||||||
|
## Alcance pendiente
|
||||||
|
|
||||||
|
OpenVPN y otras VPN requieren validación en sus redes reales. Las pruebas
|
||||||
|
Windows realizadas cubren Enterprise LTSC x64, builds 19044 y 26100; no todas
|
||||||
|
las ediciones ni builds. Azure se probó con Windows 11; la prueba de Windows 10
|
||||||
|
descrita arriba corresponde a la LAN.
|
||||||
|
|
||||||
|
El servidor debe tener SGU preparado. La IP de un DC no permite crear una VPN,
|
||||||
|
adivinar una IP libre ni sustituir permisos, DHCP o políticas de firewall.
|
||||||
@@ -0,0 +1,180 @@
|
|||||||
|
# User roaming por rol en Azure (opcional)
|
||||||
|
|
||||||
|
> **Estado predeterminado:** desactivado. Todas las cuentas `AL`, `AD`, `DO` y
|
||||||
|
> cualquier otra cuenta de dominio usan un perfil local normal bajo `C:\Users`.
|
||||||
|
> Escritorio y Documentos permanecen en el disco del equipo; no se mapean shares
|
||||||
|
> de perfiles ni se monta un contenedor FSLogix.
|
||||||
|
|
||||||
|
La implementación se conserva para un posible piloto futuro, pero no forma parte
|
||||||
|
del enrolamiento normal. Activarla requiere dos decisiones explícitas: desplegar
|
||||||
|
la infraestructura con `-DeployUserRoaming $true
|
||||||
|
-AcknowledgeUserRoamingRisks` y después ejecutar el configurador con
|
||||||
|
`-AcknowledgeUserRoamingRisks`.
|
||||||
|
|
||||||
|
## Diseño opcional
|
||||||
|
|
||||||
|
Cuando se habilita expresamente, el comportamiento es:
|
||||||
|
|
||||||
|
| Rol | Datos conservados | Implementación |
|
||||||
|
| --- | --- | --- |
|
||||||
|
| `AL` | `Desktop` y `Documents` | Redirección de carpetas a Azure Files; el resto del perfil sigue local. |
|
||||||
|
| `AD` / `DO` | Perfil completo | FSLogix VHDX: montaje directo con endpoint privado o Cloud Cache con endpoint público. |
|
||||||
|
|
||||||
|
Linux conserva su directorio personal nativo y no monta un perfil de Windows.
|
||||||
|
|
||||||
|
`infra/azure/main.bicep` puede crear una cuenta `StorageV2` dedicada con shares
|
||||||
|
`profiles` y `redirected`, soft delete de 14 días, private endpoint y zona
|
||||||
|
`privatelink.file.<sufijo-de-Azure>`. Su valor predeterminado
|
||||||
|
`deployUserRoaming=false` evita crear estos recursos. La cuenta de staging usada
|
||||||
|
para paquetes no se reutiliza automáticamente como almacenamiento de perfiles.
|
||||||
|
|
||||||
|
Los clientes de un endpoint privado requieren P2S u otra ruta privada a la VNet.
|
||||||
|
Un endpoint público exige resolución DNS, salida TCP 445 y reglas de red de
|
||||||
|
Storage limitadas a redes institucionales. El modo `Auto` selecciona `Direct`
|
||||||
|
para endpoint privado y `CloudCache` para uno público. `CCDLocations` y
|
||||||
|
`VHDLocations` son mutuamente excluyentes.
|
||||||
|
|
||||||
|
Azure Files se integra con AD DS mediante Kerberos AES-256. Las ACL de la raíz
|
||||||
|
usan `CREATOR OWNER` para aislar los directorios de usuarios. La clave de la
|
||||||
|
cuenta se usa sólo en memoria durante la creación de ACL y no se guarda en GPO.
|
||||||
|
|
||||||
|
## Riesgos que deben aceptarse
|
||||||
|
|
||||||
|
El piloto de septiembre de 2026 confirmó que esta función puede aumentar de
|
||||||
|
forma considerable el tiempo de inicio y cierre de sesión. Antes de activarla se
|
||||||
|
deben aceptar y probar, como mínimo, estos escenarios:
|
||||||
|
|
||||||
|
- latencia o indisponibilidad de Azure Files que mantiene `Welcome` o `Sign out`
|
||||||
|
durante varios minutos;
|
||||||
|
- VHDX remoto en estado abierto, pendiente de eliminación o de creación, con
|
||||||
|
fallos como `0x80070050`;
|
||||||
|
- caché o proxy local obsoleto de Cloud Cache y fallos de registro como
|
||||||
|
`0xE000000B`;
|
||||||
|
- recuperación que puede exigir detener por fuerza los servicios FSLogix y
|
||||||
|
reiniciar el equipo;
|
||||||
|
- datos todavía no sincronizados, caché local insuficiente o divergencia si se
|
||||||
|
fuerza una recuperación;
|
||||||
|
- dependencia de DNS, Kerberos, TCP 445, la red y el servicio de Storage tanto
|
||||||
|
para registrar como para desmontar el perfil.
|
||||||
|
|
||||||
|
No se debe desplegar a todos los usuarios sin un piloto de inicio, cierre,
|
||||||
|
desconexión, cuota, restauración y pérdida temporal del proveedor. Cloud Cache
|
||||||
|
reduce I/O WAN síncrono, pero no elimina la dependencia al cerrar sesión.
|
||||||
|
|
||||||
|
## 1. Desplegar la infraestructura opcional
|
||||||
|
|
||||||
|
El despliegue normal no incluye user roaming. Para crear deliberadamente sus
|
||||||
|
recursos:
|
||||||
|
|
||||||
|
```powershell
|
||||||
|
$azure = .\scripts\Deploy-SguAzureInfrastructure.ps1 `
|
||||||
|
-SubscriptionId '00000000-0000-0000-0000-000000000000' `
|
||||||
|
-ResourceGroupName 'rg-sgu-lab' `
|
||||||
|
-Location 'centralus' `
|
||||||
|
-AdministratorUsername 'azureadmin' `
|
||||||
|
-P2sRootCertificatePath $p2s.RootCertificatePath `
|
||||||
|
-DeployUserRoaming $true `
|
||||||
|
-AcknowledgeUserRoamingRisks
|
||||||
|
```
|
||||||
|
|
||||||
|
Puede definirse un nombre con `-UserRoamingStorageAccountName`. Si no se pasan
|
||||||
|
los dos parámetros de aceptación, la infraestructura de perfiles no se crea.
|
||||||
|
|
||||||
|
## 2. Unir Azure Files al dominio y publicar las GPO
|
||||||
|
|
||||||
|
Primero termine `Initialize-SguDomainController.ps1`. Después, en Windows
|
||||||
|
PowerShell 5.1 elevado dentro del DC, instale Azure PowerShell y el módulo oficial
|
||||||
|
[AzFilesHybrid](https://github.com/Azure-Samples/azure-files-samples/releases),
|
||||||
|
y ejecute:
|
||||||
|
|
||||||
|
```powershell
|
||||||
|
$parameters = @{
|
||||||
|
SubscriptionId = '00000000-0000-0000-0000-000000000000'
|
||||||
|
ResourceGroupName = 'rg-sgu-lab'
|
||||||
|
StorageAccountName = '<cuenta de perfiles>'
|
||||||
|
FsLogixProfilesShareName = 'profiles'
|
||||||
|
RedirectedFoldersShareName = 'redirected'
|
||||||
|
AzFilesHybridModulePath = 'C:\Admin\AzFilesHybrid'
|
||||||
|
UseDeviceAuthentication = $true
|
||||||
|
AcknowledgeUserRoamingRisks = $true
|
||||||
|
}
|
||||||
|
.\payload\scripts\Enable-SguAzureUserRoaming.ps1 @parameters
|
||||||
|
```
|
||||||
|
|
||||||
|
Para una cuenta autorizada con endpoint público:
|
||||||
|
|
||||||
|
```powershell
|
||||||
|
$parameters.EndpointAccess = 'Public'
|
||||||
|
$parameters.StaffProfileStorageMode = 'Auto'
|
||||||
|
.\payload\scripts\Enable-SguAzureUserRoaming.ps1 @parameters
|
||||||
|
```
|
||||||
|
|
||||||
|
El script crea las GPO `SGU - AL redirected folders` y `SGU - AD-DO FSLogix
|
||||||
|
profiles`, y vuelve a habilitar el enlace de instalación de FSLogix si ya existe.
|
||||||
|
No borra perfiles locales existentes salvo que se proporcione deliberadamente
|
||||||
|
`-DeleteExistingStaffLocalProfiles`.
|
||||||
|
|
||||||
|
## 3. Instalar FSLogix sólo para un piloto
|
||||||
|
|
||||||
|
FSLogix no forma parte de Windows. Valide su licencia y descargue
|
||||||
|
`FSLogixAppsSetup.exe` directamente de Microsoft. Puede pasarse como quinto
|
||||||
|
argumento al enrolamiento Azure o publicarse con:
|
||||||
|
|
||||||
|
```powershell
|
||||||
|
.\payload\scripts\Publish-SguFsLogixClientDeployment.ps1
|
||||||
|
```
|
||||||
|
|
||||||
|
El publicador valida firma y SHA-256 y crea `SGU - FSLogix client deployment`.
|
||||||
|
El rollback descrito abajo deshabilita su enlace para que no se instale en más
|
||||||
|
equipos.
|
||||||
|
|
||||||
|
## 4. Desactivar y volver a perfiles locales
|
||||||
|
|
||||||
|
Ejecute desde Windows PowerShell 5.1 elevado en el controlador de dominio:
|
||||||
|
|
||||||
|
```powershell
|
||||||
|
.\payload\scripts\Disable-SguAzureUserRoaming.ps1
|
||||||
|
```
|
||||||
|
|
||||||
|
Es idempotente y realiza lo siguiente:
|
||||||
|
|
||||||
|
- fija `Profiles\Enabled=0` y `ODFC\Enabled=0`;
|
||||||
|
- deshabilita `frxsvc` y `frxccds` mediante GPO;
|
||||||
|
- elimina `CCDLocations`, `VHDLocations` y valores de contenedor específicos de
|
||||||
|
los grupos `SGU-Administrativos` y `SGU-Docentes`;
|
||||||
|
- restaura Escritorio y Documentos de alumnos a
|
||||||
|
`%USERPROFILE%\Desktop` y `%USERPROFILE%\Documents`;
|
||||||
|
- deshabilita el enlace de despliegue del cliente FSLogix;
|
||||||
|
- limpia `profilePath`, `homeDirectory` y `homeDrive` de los usuarios de las OU
|
||||||
|
SGU, salvo que se use `-PreserveLegacyUserMappings`.
|
||||||
|
|
||||||
|
Después aplique `gpupdate /force` y reinicie cada Windows administrado antes de
|
||||||
|
probar un nuevo inicio de sesión. El primer ingreso vuelve a crear o reutilizar
|
||||||
|
un perfil local. El script no borra automáticamente VHDX, shares de Azure ni
|
||||||
|
cachés existentes: conservarlos permite recuperación y evita destrucción de
|
||||||
|
datos. Su eliminación debe ser una decisión separada y posterior a la validación.
|
||||||
|
|
||||||
|
## 5. Validar un piloto futuro
|
||||||
|
|
||||||
|
Después de `gpupdate /force` y reiniciar un cliente de prueba:
|
||||||
|
|
||||||
|
```powershell
|
||||||
|
Resolve-DnsName "$($azure.UserRoamingStorageAccountName).file.core.windows.net"
|
||||||
|
Test-NetConnection "$($azure.UserRoamingStorageAccountName).file.core.windows.net" -Port 445
|
||||||
|
Get-Service frxsvc
|
||||||
|
Get-ItemProperty 'HKLM:\SOFTWARE\FSLogix\Profiles\ObjectSpecific\<SID-del-grupo>'
|
||||||
|
& 'C:\Program Files\FSLogix\Apps\frx.exe' list-redirects
|
||||||
|
```
|
||||||
|
|
||||||
|
Revise `%ProgramData%\FSLogix\Logs\Profile`, pruebe inicio y cierre varias veces,
|
||||||
|
simule indisponibilidad y valide restauración. No active el borrado de perfiles
|
||||||
|
locales ni amplíe el alcance antes de superar esas pruebas.
|
||||||
|
|
||||||
|
Referencias de Microsoft:
|
||||||
|
|
||||||
|
- [Autenticación AD DS para Azure Files](https://learn.microsoft.com/azure/storage/files/storage-files-identity-ad-ds-enable)
|
||||||
|
- [Permisos SMB para FSLogix](https://learn.microsoft.com/fslogix/how-to-configure-storage-permissions)
|
||||||
|
- [Contenedores de perfil FSLogix](https://learn.microsoft.com/fslogix/how-to-configure-profile-containers)
|
||||||
|
- [Configuración ObjectSpecific de FSLogix](https://learn.microsoft.com/fslogix/how-to-configure-object-specific-settings)
|
||||||
|
- [Cloud Cache de FSLogix](https://learn.microsoft.com/fslogix/concepts-fslogix-cloud-cache)
|
||||||
|
- [Redirección de carpetas](https://learn.microsoft.com/windows-server/storage/folder-redirection/deploy-folder-redirection)
|
||||||
@@ -0,0 +1,103 @@
|
|||||||
|
# Fondo de bienvenida personalizado
|
||||||
|
|
||||||
|
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
|
||||||
|
`SGU - Windows client experience` ejecuta el generador al abrir cada sesión y
|
||||||
|
mantiene la base limpia independiente en la pantalla de bloqueo.
|
||||||
|
|
||||||
|
Windows no conoce todavía la identidad que se autenticará mientras muestra la
|
||||||
|
pantalla previa al inicio de sesión. Por ello, esa pantalla utiliza el fondo base
|
||||||
|
sin datos personales y la composición individual se genera inmediatamente
|
||||||
|
después de autenticar, antes de que el usuario empiece a trabajar en el escritorio.
|
||||||
|
|
||||||
|
## Datos y degradación controlada
|
||||||
|
|
||||||
|
El generador consulta Active Directory con la identidad ya autenticada y sin
|
||||||
|
guardar credenciales. Obtiene:
|
||||||
|
|
||||||
|
- `displayName` del usuario; si falta, utiliza `sAMAccountName`.
|
||||||
|
- La línea administrada `SGU-Gender: Male|Female` del atributo `info`; el Auth
|
||||||
|
Broker la obtiene del SGU y conserva cualquier otra nota que ya exista.
|
||||||
|
- `location` del objeto de equipo.
|
||||||
|
- La OU padre inmediata a partir de `distinguishedName`.
|
||||||
|
|
||||||
|
Los valores de equipo `SGU_WELCOME_LOCATION` y
|
||||||
|
`SGU_WELCOME_ORGANIZATIONAL_UNIT` pueden fijar ambos datos en una máquina
|
||||||
|
concreta. Tienen prioridad sobre el directorio y sobreviven cuando la GPO
|
||||||
|
restaura el comando genérico de inicio.
|
||||||
|
|
||||||
|
El saludo usa `Bienvenido/ubicado` para `Male` y `Bienvenida/ubicada` para
|
||||||
|
`Female`. Cuando el enriquecimiento no produjo este dato, utiliza la redacción
|
||||||
|
neutral `Te damos la bienvenida` y `Acceso`. La ubicación se divide en dos
|
||||||
|
líneas: la sala ocupa la primera y la dependencia aparece debajo con un tamaño
|
||||||
|
menor. Sigue estas reglas:
|
||||||
|
|
||||||
|
1. Sin sexo: `Acceso a la Sala de Aplicaciones`, seguido por
|
||||||
|
`del Laboratorio de Cómputo de Ingeniería.`
|
||||||
|
2. Masculino: `Estás ubicado en el Aula Flexible`, seguido por
|
||||||
|
`del Centro de Experiencia Digital.`
|
||||||
|
3. Femenino: `Estás ubicada en la Sala de Redes`, seguido por
|
||||||
|
`del Laboratorio de Cómputo de Ingeniería.`
|
||||||
|
4. Con sólo uno de los datos: muestra únicamente el dato disponible.
|
||||||
|
5. Sin ambos: el texto adaptado `Bienvenido/Bienvenida al Laboratorio...`; sin
|
||||||
|
sexo disponible, la forma neutral `Acceso al Laboratorio de Cómputo de Ingeniería.`
|
||||||
|
|
||||||
|
La ausencia de AD, de un atributo o de una tipografía nunca bloquea la sesión.
|
||||||
|
Los errores de generación se registran en
|
||||||
|
`%LOCALAPPDATA%\SGU\Logs\welcome-wallpaper.log`.
|
||||||
|
|
||||||
|
## Windows
|
||||||
|
|
||||||
|
El paquete de cliente copia los recursos a `C:\ProgramData\SGU\Branding`. La
|
||||||
|
GPO crea el valor de equipo `SGUWelcomeWallpaper` bajo
|
||||||
|
`HKLM\Software\Microsoft\Windows\CurrentVersion\Run`; por tanto, se ejecuta en
|
||||||
|
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.
|
||||||
|
La GPO configura tanto la directiva clásica como `PersonalizationCSP` y desactiva
|
||||||
|
Windows Spotlight en la pantalla de bloqueo, porque Windows 11 Pro puede ignorar
|
||||||
|
la ruta clásica aun cuando el valor de registro está presente.
|
||||||
|
|
||||||
|
## Linux
|
||||||
|
|
||||||
|
El paquete Linux instala el generador en
|
||||||
|
`/usr/local/lib/sgu-welcome-wallpaper` y registra
|
||||||
|
`/etc/xdg/autostart/sgu-welcome-wallpaper.desktop`. Utiliza el ticket Kerberos
|
||||||
|
creado por SSSD para consultar el objeto de equipo mediante LDAP; nunca contiene
|
||||||
|
una contraseña de enlace.
|
||||||
|
|
||||||
|
Se admiten Cinnamon, GNOME y XFCE. La composición requiere ImageMagick; si la
|
||||||
|
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
|
||||||
|
para renderizar el fondo; no se sustituyen fuentes del sistema. Se usa Sans en el
|
||||||
|
saludo y la ubicación, y Serif Bold Italic en el nombre. Si los archivos no
|
||||||
|
pueden cargarse, Windows usa Segoe UI/Georgia y Linux usa DejaVu Sans/Serif.
|
||||||
@@ -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
|
equipo unido al dominio. No modifica ni oculta el proveedor de contraseña de
|
||||||
Microsoft; **Other user** permanece como ruta de recuperación.
|
Microsoft; **Other user** permanece como ruta de recuperación.
|
||||||
|
|
||||||
Cerrar sesión o reiniciar el equipo. El acceso SGU debe quedar seleccionado por
|
Cerrar sesión o reiniciar el equipo. **Acceso Institucional** debe quedar
|
||||||
defecto y el proveedor de contraseña de Microsoft debe permanecer disponible.
|
seleccionado por defecto; el proveedor nativo de Microsoft permanece disponible
|
||||||
|
para recuperación.
|
||||||
|
|
||||||
## 5. Verificación
|
## 5. Verificación
|
||||||
|
|
||||||
@@ -129,6 +130,12 @@ configuración siempre activa y evita las experiencias iniciales de privacidad,
|
|||||||
telemetría, ubicación y **Hi / Preparing Windows** antes de que un usuario SGU
|
telemetría, ubicación y **Hi / Preparing Windows** antes de que un usuario SGU
|
||||||
entre por primera vez.
|
entre por primera vez.
|
||||||
|
|
||||||
|
La misma GPO configura el fondo azul de bloqueo y ejecuta el generador local al
|
||||||
|
abrir cada sesión. El generador usa el `displayName` del usuario, la propiedad
|
||||||
|
`location` del equipo y su OU padre inmediata para crear el fondo individual.
|
||||||
|
Consulta [welcome-wallpaper.md](welcome-wallpaper.md) para conocer los fallbacks
|
||||||
|
y la ubicación de los diagnósticos.
|
||||||
|
|
||||||
Microsoft documenta este derecho en:
|
Microsoft documenta este derecho en:
|
||||||
<https://learn.microsoft.com/en-us/windows/client-management/mdm/policy-csp-userrights#allowlogonthroughremotedesktop>
|
<https://learn.microsoft.com/en-us/windows/client-management/mdm/policy-csp-userrights#allowlogonthroughremotedesktop>
|
||||||
y PowerShell Remoting en:
|
y PowerShell Remoting en:
|
||||||
|
|||||||
@@ -0,0 +1,33 @@
|
|||||||
|
# Administradores de las estaciones Windows
|
||||||
|
|
||||||
|
El grupo `LCI\Administrators` ubicado en `CN=Builtin` administra Active
|
||||||
|
Directory y los controladores de dominio. No convierte por sí solo a sus
|
||||||
|
miembros en administradores locales de las estaciones Windows. `Domain Admins`
|
||||||
|
sí suele estar en el grupo local `Administrators` de cada equipo unido al
|
||||||
|
dominio, pero agregar una cuenta a `Domain Admins` le daría mucho más alcance.
|
||||||
|
|
||||||
|
La GPO **SGU - Windows client experience**, vinculada a `OU=Laboratorio`,
|
||||||
|
ejecuta `Enable-SguWorkstationAdministrators.ps1` al inicio de cada equipo
|
||||||
|
Windows. El script consulta por LDAP a los usuarios (incluidos miembros
|
||||||
|
anidados) de `CN=Administrators,CN=Builtin,DC=lci,DC=lasalle,DC=mx` y agrega
|
||||||
|
sus SID de dominio al grupo `Administrators` local. No se aplica a los
|
||||||
|
controladores de dominio ni a los equipos Linux. Si el DC no responde, no
|
||||||
|
cambia la pertenencia local y lo reintenta en el siguiente arranque.
|
||||||
|
|
||||||
|
En siguientes arranques elimina solo los SID que esta política había agregado
|
||||||
|
y que ya no pertenecen al grupo de AD. Conserva los administradores locales
|
||||||
|
y los grupos agregados por otras políticas. Los cambios de membresía de AD
|
||||||
|
requieren reiniciar la estación y volver a iniciar sesión para obtener un
|
||||||
|
token de acceso nuevo; no se elevan las sesiones ya abiertas.
|
||||||
|
|
||||||
|
Comprobación en un cliente Windows, desde una consola elevada:
|
||||||
|
|
||||||
|
```powershell
|
||||||
|
gpresult /scope computer /r
|
||||||
|
Get-LocalGroupMember -SID 'S-1-5-32-544'
|
||||||
|
whoami /groups
|
||||||
|
```
|
||||||
|
|
||||||
|
Para actualizar la política en un equipo encendido, ejecute
|
||||||
|
`gpupdate /target:computer /force`, reinicie e inicie sesión nuevamente. La
|
||||||
|
concesión se limita a los equipos Windows que heredan la GPO del laboratorio.
|
||||||
@@ -0,0 +1,105 @@
|
|||||||
|
# Acceso remoto administrado por el dominio
|
||||||
|
|
||||||
|
`Install-SguDomainRemoteManagementPolicy.ps1` crea **La Salle - Workstation
|
||||||
|
remote management**, vinculada y exigida en la raíz del dominio. Su filtro WMI
|
||||||
|
`ProductType = 1` incluye estaciones Windows 10/11, incluso las nuevas cuentas
|
||||||
|
en `CN=Computers`, y excluye servidores y controladores de dominio. Solo tiene
|
||||||
|
configuración de equipo. El bootstrap del controlador instala esta política.
|
||||||
|
|
||||||
|
La política usa extensiones nativas de Group Policy:
|
||||||
|
|
||||||
|
- Plantillas administrativas: RDP permitido con NLA, listener WinRM y consola remota.
|
||||||
|
- Preferencias de servicios: `WinRM` y `TermService` automáticos, iniciados cuando
|
||||||
|
sea necesario; `RemoteRegistry` manual. No reinicia servicios que ya funcionan.
|
||||||
|
- Preferencias de registro: activa RDP también en la configuración local que
|
||||||
|
muestra Configuración de Windows.
|
||||||
|
- Firewall de dominio: 12 reglas para RDP TCP/UDP, WinRM, WMI, RPC, eventos,
|
||||||
|
servicios, tareas, firewall, volúmenes, rendimiento y SMB administrativo.
|
||||||
|
Los puertos RPC dinámicos se limitan al servicio correspondiente.
|
||||||
|
|
||||||
|
Por defecto, las reglas solo permiten conexiones desde `LocalSubnet`.
|
||||||
|
`-ManagementAddresses` permite especificar otras redes administrativas que
|
||||||
|
ya tengan rutas hacia las estaciones. El instalador compara valores, reglas,
|
||||||
|
archivos y vínculos; una segunda ejecución sin diferencias no modifica la GPO.
|
||||||
|
|
||||||
|
```powershell
|
||||||
|
# En PowerShell elevado del controlador de dominio:
|
||||||
|
.\scripts\Install-SguDomainRemoteManagementPolicy.ps1 -DomainController SGU-DC02
|
||||||
|
|
||||||
|
# Configuración del despliegue actual de Aula Flexible:
|
||||||
|
.\scripts\Install-SguDomainRemoteManagementPolicy.ps1 -DomainController SGU-DC02 `
|
||||||
|
-LocalDnsServer 192.168.54.211 -FallbackDnsServer 20.9.81.130 `
|
||||||
|
-ManagementAddresses @('LocalSubnet','192.168.54.211')
|
||||||
|
```
|
||||||
|
|
||||||
|
Un script de **inicio de equipo de la propia GPO** prepara el endpoint de
|
||||||
|
Windows PowerShell si está ausente o deshabilitado y comprueba el grupo RDP
|
||||||
|
institucional. No crea tareas periódicas en las estaciones. La política
|
||||||
|
preexistente **SGU - Windows client experience** conserva sus scripts de inicio
|
||||||
|
para Laboratorio y la asignación de administradores; véase
|
||||||
|
[Administradores de las estaciones Windows](workstation-administrators.md).
|
||||||
|
|
||||||
|
Si se proporciona DNS local, el script de inicio solo modifica una interfaz
|
||||||
|
cuyo segmento conectado contiene ese servidor, después de comprobar que
|
||||||
|
responde autoritativamente para el dominio. Puede usar otro DNS de AD como
|
||||||
|
alternativa y solicita el registro DNS del equipo. Conserva las interfaces
|
||||||
|
de otras redes.
|
||||||
|
|
||||||
|
Para aplicar la política a un cliente, ejecute PowerShell como administrador:
|
||||||
|
|
||||||
|
```powershell
|
||||||
|
gpupdate /target:computer /force
|
||||||
|
gpresult /scope computer /r
|
||||||
|
Test-ComputerSecureChannel -Verbose
|
||||||
|
Get-Service WinRM,TermService | Select-Object Name,Status,StartType
|
||||||
|
Get-NetFirewallRule -PolicyStore ActiveStore -Name 'LaSalle-Management-*' |
|
||||||
|
Select-Object Name,Enabled,PolicyStoreSourceType
|
||||||
|
```
|
||||||
|
|
||||||
|
La GPO debe figurar aplicada, el canal seguro devolver `True`, ambos servicios
|
||||||
|
estar activos y las 12 reglas habilitadas con origen `GroupPolicy`.
|
||||||
|
`gpupdate` aplica registro, servicios y firewall sin cerrar la sesión. Reiniciar
|
||||||
|
una vez ejecuta además la preparación inicial del endpoint y DNS. La actualización
|
||||||
|
del proveedor de credenciales es otra GPO de inicio y necesita su propio reinicio.
|
||||||
|
|
||||||
|
Para revisar varias estaciones desde SGU-DC02, con una cuenta de administración
|
||||||
|
del dominio:
|
||||||
|
|
||||||
|
```powershell
|
||||||
|
.\scripts\Get-SguWorkstationRemoteManagementStatus.ps1 -ComputerName `
|
||||||
|
AF-02.lci.lasalle.mx,AF-03.lci.lasalle.mx -RefreshPolicy | Format-Table
|
||||||
|
|
||||||
|
# Sin ComputerName, consulta todas las estaciones Windows habilitadas de AD.
|
||||||
|
.\scripts\Get-SguWorkstationRemoteManagementStatus.ps1 | Format-Table
|
||||||
|
```
|
||||||
|
|
||||||
|
Un cliente con canal seguro roto necesita primero reparar su relación de
|
||||||
|
confianza con credenciales autorizadas. No elimine su objeto de AD para forzar
|
||||||
|
la aplicación de una política. Un equipo apagado o sin conectividad recibirá
|
||||||
|
la configuración cuando vuelva a contactar con el dominio.
|
||||||
|
|
||||||
|
Las GPO habilitan la administración de las estaciones. El inventario de conexiones
|
||||||
|
de WAC se mantiene en el gateway y se registra por separado:
|
||||||
|
|
||||||
|
```powershell
|
||||||
|
.\scripts\Sync-SguWacDomainConnections.ps1 -Endpoint https://sgu-dc02/ `
|
||||||
|
-Credential (Get-Credential 'LCI\azureadmin') -DomainController SGU-DC02
|
||||||
|
```
|
||||||
|
|
||||||
|
El script usa el inicio de sesión nativo de WAC v2 mediante HTTPS, CSRF y
|
||||||
|
RSA-OAEP-SHA256. No cambia la autenticación ni almacena la contraseña. Añade
|
||||||
|
conexiones **compartidas** para las cuentas Windows habilitadas de AD que tengan
|
||||||
|
nombre DNS, conserva las conexiones existentes y verifica que no falte ninguna.
|
||||||
|
Si se repite, no vuelve a añadir las mismas conexiones. Ejecútelo de nuevo al
|
||||||
|
añadir equipos al dominio, o use **Agregar → Buscar en Active Directory** en WAC;
|
||||||
|
no hay un sondeo periódico instalado para mantener esta lista.
|
||||||
|
|
||||||
|
`-VerifyNodes AF-02.lci.lasalle.mx,AF-03.lci.lasalle.mx` comprueba además que el
|
||||||
|
gateway pueda consultar instancias del sistema operativo mediante su API CIM.
|
||||||
|
La presencia de una conexión en la lista no implica que esté encendida.
|
||||||
|
|
||||||
|
Desde un equipo administrador no unido al dominio, PowerShell Remoting por
|
||||||
|
HTTP requiere indicar `-Credential` y confiar explícitamente en el destino
|
||||||
|
mediante `TrustedHosts`, o utilizar WinRM por HTTPS. `Test-WSMan` solo verifica
|
||||||
|
el listener; no inicia sesión. Las reglas locales de la estación no abren
|
||||||
|
puertos en Azure ni en el router del laboratorio.
|
||||||
@@ -0,0 +1,576 @@
|
|||||||
|
targetScope = 'resourceGroup'
|
||||||
|
|
||||||
|
@description('Short prefix used for every Azure resource.')
|
||||||
|
@minLength(3)
|
||||||
|
@maxLength(18)
|
||||||
|
param deploymentPrefix string = 'sgu-lab'
|
||||||
|
|
||||||
|
@description('Azure region for the virtual network, gateway, and VM.')
|
||||||
|
param location string = resourceGroup().location
|
||||||
|
|
||||||
|
@description('Windows Server VM administrator name. This must not be Administrator.')
|
||||||
|
@minLength(1)
|
||||||
|
@maxLength(20)
|
||||||
|
param administratorUsername string
|
||||||
|
|
||||||
|
@secure()
|
||||||
|
@description('Windows Server VM administrator password.')
|
||||||
|
param administratorPassword string
|
||||||
|
|
||||||
|
@description('Windows Server computer name; Active Directory limits this to 15 characters.')
|
||||||
|
@minLength(1)
|
||||||
|
@maxLength(15)
|
||||||
|
param computerName string = 'SGU-DC01'
|
||||||
|
|
||||||
|
@description('VM size for the Windows Server 2025 domain controller.')
|
||||||
|
param vmSize string = 'Standard_D2s_v5'
|
||||||
|
|
||||||
|
@description('Address space assigned to the Azure virtual network.')
|
||||||
|
param virtualNetworkAddressPrefix string = '10.77.0.0/16'
|
||||||
|
|
||||||
|
@description('Subnet that contains the domain controller.')
|
||||||
|
param domainControllerSubnetPrefix string = '10.77.0.0/24'
|
||||||
|
|
||||||
|
@description('Reserved Azure VPN Gateway subnet. Use /27 or larger.')
|
||||||
|
param gatewaySubnetPrefix string = '10.77.255.0/27'
|
||||||
|
|
||||||
|
@description('Deploy the optional Azure Point-to-Site VPN Gateway. Direct public enrollment does not require it.')
|
||||||
|
param deployVpnGateway bool = true
|
||||||
|
|
||||||
|
@description('Static private IP reserved on the Azure NIC for AD DS and DNS.')
|
||||||
|
param domainControllerPrivateIp string = '10.77.0.4'
|
||||||
|
|
||||||
|
@description('Point-to-site client pool. It must not overlap the VNet or local Hyper-V networks.')
|
||||||
|
param vpnClientAddressPoolPrefix string = '172.30.0.0/24'
|
||||||
|
|
||||||
|
@description('Name presented for the trusted P2S root certificate.')
|
||||||
|
param p2sRootCertificateName string = 'SGU-P2S-Root'
|
||||||
|
|
||||||
|
@description('Base64 DER bytes of the trusted P2S root certificate, without PEM markers.')
|
||||||
|
param p2sRootCertificateData string = ''
|
||||||
|
|
||||||
|
@description('Public IPv4 CIDRs allowed to enroll clients directly without VPN. Leave empty to expose no AD enrollment ports.')
|
||||||
|
param publicEnrollmentSourceAddressPrefixes array = []
|
||||||
|
|
||||||
|
@description('Optional public CIDR allowed to RDP to the VM public IP, for example 203.0.113.10/32. Leave empty to expose no management port.')
|
||||||
|
param administratorSourceAddressPrefix string = ''
|
||||||
|
|
||||||
|
@description('Deploy private Azure Files shares for SGU user roaming. Clients require P2S or another private route into the VNet.')
|
||||||
|
param deployUserRoaming bool = false
|
||||||
|
|
||||||
|
@description('Optional globally unique storage account name for roaming data. Leave empty to derive a stable name from the resource group.')
|
||||||
|
param userRoamingStorageAccountName string = ''
|
||||||
|
|
||||||
|
@description('Azure Files share used for AD/DO FSLogix profile containers.')
|
||||||
|
@minLength(3)
|
||||||
|
@maxLength(63)
|
||||||
|
param fsLogixProfilesShareName string = 'profiles'
|
||||||
|
|
||||||
|
@description('Azure Files share used for AL Documents and Desktop folder redirection.')
|
||||||
|
@minLength(3)
|
||||||
|
@maxLength(63)
|
||||||
|
param redirectedFoldersShareName string = 'redirected'
|
||||||
|
|
||||||
|
@description('Quota in GiB for the FSLogix profile-container share.')
|
||||||
|
@minValue(100)
|
||||||
|
@maxValue(102400)
|
||||||
|
param fsLogixProfilesQuotaGiB int = 1024
|
||||||
|
|
||||||
|
@description('Quota in GiB for the redirected-folders share.')
|
||||||
|
@minValue(100)
|
||||||
|
@maxValue(102400)
|
||||||
|
param redirectedFoldersQuotaGiB int = 1024
|
||||||
|
|
||||||
|
var virtualNetworkName = '${deploymentPrefix}-vnet'
|
||||||
|
var domainControllerSubnetName = 'DomainControllers'
|
||||||
|
var gatewaySubnetName = 'GatewaySubnet'
|
||||||
|
var networkSecurityGroupName = '${deploymentPrefix}-dc-nsg'
|
||||||
|
var domainControllerPublicIpName = '${deploymentPrefix}-dc-pip'
|
||||||
|
var gatewayPublicIpName = '${deploymentPrefix}-vpngw-pip'
|
||||||
|
var networkInterfaceName = '${deploymentPrefix}-dc-nic'
|
||||||
|
var virtualMachineName = '${deploymentPrefix}-dc'
|
||||||
|
var virtualNetworkGatewayName = '${deploymentPrefix}-vpngw'
|
||||||
|
var effectiveUserRoamingStorageAccountName = empty(userRoamingStorageAccountName)
|
||||||
|
? 'sguroam${uniqueString(resourceGroup().id)}'
|
||||||
|
: toLower(userRoamingStorageAccountName)
|
||||||
|
var userRoamingPrivateEndpointName = '${deploymentPrefix}-profiles-pe'
|
||||||
|
var storageEndpointSuffix = environment().suffixes.storage
|
||||||
|
var azureFilesPrivateDnsZoneName = 'privatelink.file.${storageEndpointSuffix}'
|
||||||
|
|
||||||
|
resource networkSecurityGroup 'Microsoft.Network/networkSecurityGroups@2024-05-01' = {
|
||||||
|
name: networkSecurityGroupName
|
||||||
|
location: location
|
||||||
|
properties: {
|
||||||
|
securityRules: concat(deployVpnGateway ? [
|
||||||
|
{
|
||||||
|
name: 'Allow-SGU-P2S-clients'
|
||||||
|
properties: {
|
||||||
|
priority: 100
|
||||||
|
access: 'Allow'
|
||||||
|
direction: 'Inbound'
|
||||||
|
protocol: '*'
|
||||||
|
sourcePortRange: '*'
|
||||||
|
destinationPortRange: '*'
|
||||||
|
sourceAddressPrefix: vpnClientAddressPoolPrefix
|
||||||
|
destinationAddressPrefix: domainControllerPrivateIp
|
||||||
|
description: 'AD, DNS, broker, monitoring, and RustDesk are reachable only through the authenticated P2S address pool.'
|
||||||
|
}
|
||||||
|
}
|
||||||
|
] : [], empty(publicEnrollmentSourceAddressPrefixes) ? [] : [
|
||||||
|
{
|
||||||
|
name: 'Allow-Direct-AD-TCP'
|
||||||
|
properties: {
|
||||||
|
priority: 110
|
||||||
|
access: 'Allow'
|
||||||
|
direction: 'Inbound'
|
||||||
|
protocol: 'Tcp'
|
||||||
|
sourcePortRange: '*'
|
||||||
|
destinationPortRanges: [
|
||||||
|
'53'
|
||||||
|
'88'
|
||||||
|
'135'
|
||||||
|
'389'
|
||||||
|
'443'
|
||||||
|
'445'
|
||||||
|
'464'
|
||||||
|
'636'
|
||||||
|
'3268'
|
||||||
|
'3269'
|
||||||
|
'21115-21117'
|
||||||
|
'49152-65535'
|
||||||
|
]
|
||||||
|
sourceAddressPrefixes: publicEnrollmentSourceAddressPrefixes
|
||||||
|
destinationAddressPrefix: domainControllerPrivateIp
|
||||||
|
description: 'AD, DoH, and RustDesk TCP access for explicitly authorized public enrollment networks.'
|
||||||
|
}
|
||||||
|
}
|
||||||
|
{
|
||||||
|
name: 'Allow-Direct-AD-UDP'
|
||||||
|
properties: {
|
||||||
|
priority: 120
|
||||||
|
access: 'Allow'
|
||||||
|
direction: 'Inbound'
|
||||||
|
protocol: 'Udp'
|
||||||
|
sourcePortRange: '*'
|
||||||
|
destinationPortRanges: [
|
||||||
|
'53'
|
||||||
|
'88'
|
||||||
|
'123'
|
||||||
|
'389'
|
||||||
|
'464'
|
||||||
|
'21116'
|
||||||
|
]
|
||||||
|
sourceAddressPrefixes: publicEnrollmentSourceAddressPrefixes
|
||||||
|
destinationAddressPrefix: domainControllerPrivateIp
|
||||||
|
description: 'AD, time, and RustDesk UDP access for explicitly authorized public enrollment networks.'
|
||||||
|
}
|
||||||
|
}
|
||||||
|
{
|
||||||
|
name: 'Allow-Direct-SGU-Enrollment-TCP'
|
||||||
|
properties: {
|
||||||
|
priority: 130
|
||||||
|
access: 'Allow'
|
||||||
|
direction: 'Inbound'
|
||||||
|
protocol: 'Tcp'
|
||||||
|
sourcePortRange: '*'
|
||||||
|
destinationPortRanges: [
|
||||||
|
'5985'
|
||||||
|
'8443'
|
||||||
|
]
|
||||||
|
sourceAddressPrefixes: publicEnrollmentSourceAddressPrefixes
|
||||||
|
destinationAddressPrefix: domainControllerPrivateIp
|
||||||
|
description: 'WinRM discovery and SGU broker access for direct enrollment.'
|
||||||
|
}
|
||||||
|
}
|
||||||
|
], empty(administratorSourceAddressPrefix) ? [] : [
|
||||||
|
{
|
||||||
|
name: 'Allow-RDP-from-administrator'
|
||||||
|
properties: {
|
||||||
|
priority: 140
|
||||||
|
access: 'Allow'
|
||||||
|
direction: 'Inbound'
|
||||||
|
protocol: 'Tcp'
|
||||||
|
sourcePortRange: '*'
|
||||||
|
destinationPortRange: '3389'
|
||||||
|
sourceAddressPrefix: administratorSourceAddressPrefix
|
||||||
|
destinationAddressPrefix: domainControllerPrivateIp
|
||||||
|
description: 'Optional bootstrap-only RDP access from one explicitly supplied public CIDR.'
|
||||||
|
}
|
||||||
|
}
|
||||||
|
])
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
resource virtualNetwork 'Microsoft.Network/virtualNetworks@2024-05-01' = {
|
||||||
|
name: virtualNetworkName
|
||||||
|
location: location
|
||||||
|
properties: {
|
||||||
|
addressSpace: {
|
||||||
|
addressPrefixes: [
|
||||||
|
virtualNetworkAddressPrefix
|
||||||
|
]
|
||||||
|
}
|
||||||
|
dhcpOptions: {
|
||||||
|
dnsServers: [
|
||||||
|
domainControllerPrivateIp
|
||||||
|
]
|
||||||
|
}
|
||||||
|
subnets: concat([
|
||||||
|
{
|
||||||
|
name: domainControllerSubnetName
|
||||||
|
properties: {
|
||||||
|
addressPrefix: domainControllerSubnetPrefix
|
||||||
|
privateEndpointNetworkPolicies: deployUserRoaming ? 'Disabled' : null
|
||||||
|
networkSecurityGroup: {
|
||||||
|
id: networkSecurityGroup.id
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
], deployVpnGateway ? [
|
||||||
|
{
|
||||||
|
name: gatewaySubnetName
|
||||||
|
properties: {
|
||||||
|
addressPrefix: gatewaySubnetPrefix
|
||||||
|
}
|
||||||
|
}
|
||||||
|
] : [])
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
resource userRoamingStorageAccount 'Microsoft.Storage/storageAccounts@2023-05-01' = if (deployUserRoaming) {
|
||||||
|
name: effectiveUserRoamingStorageAccountName
|
||||||
|
location: location
|
||||||
|
tags: {
|
||||||
|
purpose: 'SGU-user-roaming'
|
||||||
|
}
|
||||||
|
sku: {
|
||||||
|
name: 'Standard_LRS'
|
||||||
|
}
|
||||||
|
kind: 'StorageV2'
|
||||||
|
properties: {
|
||||||
|
accessTier: 'Hot'
|
||||||
|
allowBlobPublicAccess: false
|
||||||
|
allowCrossTenantReplication: false
|
||||||
|
allowSharedKeyAccess: true
|
||||||
|
largeFileSharesState: 'Enabled'
|
||||||
|
minimumTlsVersion: 'TLS1_2'
|
||||||
|
publicNetworkAccess: 'Disabled'
|
||||||
|
supportsHttpsTrafficOnly: true
|
||||||
|
networkAcls: {
|
||||||
|
bypass: 'AzureServices'
|
||||||
|
defaultAction: 'Deny'
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
resource userRoamingFileService 'Microsoft.Storage/storageAccounts/fileServices@2023-05-01' = if (deployUserRoaming) {
|
||||||
|
parent: userRoamingStorageAccount
|
||||||
|
name: 'default'
|
||||||
|
properties: {
|
||||||
|
shareDeleteRetentionPolicy: {
|
||||||
|
enabled: true
|
||||||
|
days: 14
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
resource fsLogixProfilesShare 'Microsoft.Storage/storageAccounts/fileServices/shares@2023-05-01' = if (deployUserRoaming) {
|
||||||
|
parent: userRoamingFileService
|
||||||
|
name: fsLogixProfilesShareName
|
||||||
|
properties: {
|
||||||
|
accessTier: 'TransactionOptimized'
|
||||||
|
enabledProtocols: 'SMB'
|
||||||
|
shareQuota: fsLogixProfilesQuotaGiB
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
resource redirectedFoldersShare 'Microsoft.Storage/storageAccounts/fileServices/shares@2023-05-01' = if (deployUserRoaming) {
|
||||||
|
parent: userRoamingFileService
|
||||||
|
name: redirectedFoldersShareName
|
||||||
|
properties: {
|
||||||
|
accessTier: 'TransactionOptimized'
|
||||||
|
enabledProtocols: 'SMB'
|
||||||
|
shareQuota: redirectedFoldersQuotaGiB
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
resource azureFilesPrivateDnsZone 'Microsoft.Network/privateDnsZones@2020-06-01' = if (deployUserRoaming) {
|
||||||
|
name: azureFilesPrivateDnsZoneName
|
||||||
|
location: 'global'
|
||||||
|
}
|
||||||
|
|
||||||
|
resource azureFilesPrivateDnsVnetLink 'Microsoft.Network/privateDnsZones/virtualNetworkLinks@2020-06-01' = if (deployUserRoaming) {
|
||||||
|
parent: azureFilesPrivateDnsZone
|
||||||
|
name: '${deploymentPrefix}-vnet-link'
|
||||||
|
location: 'global'
|
||||||
|
properties: {
|
||||||
|
registrationEnabled: false
|
||||||
|
virtualNetwork: {
|
||||||
|
id: virtualNetwork.id
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
resource userRoamingPrivateEndpoint 'Microsoft.Network/privateEndpoints@2024-05-01' = if (deployUserRoaming) {
|
||||||
|
name: userRoamingPrivateEndpointName
|
||||||
|
location: location
|
||||||
|
properties: {
|
||||||
|
subnet: {
|
||||||
|
id: resourceId('Microsoft.Network/virtualNetworks/subnets', virtualNetworkName, domainControllerSubnetName)
|
||||||
|
}
|
||||||
|
privateLinkServiceConnections: [
|
||||||
|
{
|
||||||
|
name: 'azure-files'
|
||||||
|
properties: {
|
||||||
|
groupIds: [
|
||||||
|
'file'
|
||||||
|
]
|
||||||
|
privateLinkServiceId: userRoamingStorageAccount.id
|
||||||
|
}
|
||||||
|
}
|
||||||
|
]
|
||||||
|
}
|
||||||
|
dependsOn: [
|
||||||
|
virtualNetwork
|
||||||
|
]
|
||||||
|
}
|
||||||
|
|
||||||
|
resource userRoamingPrivateDnsZoneGroup 'Microsoft.Network/privateEndpoints/privateDnsZoneGroups@2024-05-01' = if (deployUserRoaming) {
|
||||||
|
parent: userRoamingPrivateEndpoint
|
||||||
|
name: 'default'
|
||||||
|
properties: {
|
||||||
|
privateDnsZoneConfigs: [
|
||||||
|
{
|
||||||
|
name: 'azure-files'
|
||||||
|
properties: {
|
||||||
|
privateDnsZoneId: azureFilesPrivateDnsZone.id
|
||||||
|
}
|
||||||
|
}
|
||||||
|
]
|
||||||
|
}
|
||||||
|
dependsOn: [
|
||||||
|
azureFilesPrivateDnsVnetLink
|
||||||
|
]
|
||||||
|
}
|
||||||
|
|
||||||
|
resource domainControllerPublicIp 'Microsoft.Network/publicIPAddresses@2024-05-01' = {
|
||||||
|
name: domainControllerPublicIpName
|
||||||
|
location: location
|
||||||
|
sku: {
|
||||||
|
name: 'Standard'
|
||||||
|
}
|
||||||
|
properties: {
|
||||||
|
publicIPAllocationMethod: 'Static'
|
||||||
|
publicIPAddressVersion: 'IPv4'
|
||||||
|
idleTimeoutInMinutes: 30
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
resource gatewayPublicIp 'Microsoft.Network/publicIPAddresses@2024-05-01' = if (deployVpnGateway) {
|
||||||
|
name: gatewayPublicIpName
|
||||||
|
location: location
|
||||||
|
zones: [
|
||||||
|
'1'
|
||||||
|
'2'
|
||||||
|
'3'
|
||||||
|
]
|
||||||
|
sku: {
|
||||||
|
name: 'Standard'
|
||||||
|
}
|
||||||
|
properties: {
|
||||||
|
publicIPAllocationMethod: 'Static'
|
||||||
|
publicIPAddressVersion: 'IPv4'
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
resource networkInterface 'Microsoft.Network/networkInterfaces@2024-05-01' = {
|
||||||
|
name: networkInterfaceName
|
||||||
|
location: location
|
||||||
|
properties: {
|
||||||
|
enableAcceleratedNetworking: true
|
||||||
|
dnsSettings: {
|
||||||
|
dnsServers: [
|
||||||
|
domainControllerPrivateIp
|
||||||
|
]
|
||||||
|
}
|
||||||
|
ipConfigurations: [
|
||||||
|
{
|
||||||
|
name: 'ipconfig1'
|
||||||
|
properties: {
|
||||||
|
privateIPAllocationMethod: 'Static'
|
||||||
|
privateIPAddressVersion: 'IPv4'
|
||||||
|
privateIPAddress: domainControllerPrivateIp
|
||||||
|
subnet: {
|
||||||
|
id: resourceId('Microsoft.Network/virtualNetworks/subnets', virtualNetworkName, domainControllerSubnetName)
|
||||||
|
}
|
||||||
|
publicIPAddress: {
|
||||||
|
id: domainControllerPublicIp.id
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
]
|
||||||
|
}
|
||||||
|
dependsOn: [
|
||||||
|
virtualNetwork
|
||||||
|
]
|
||||||
|
}
|
||||||
|
|
||||||
|
resource virtualMachine 'Microsoft.Compute/virtualMachines@2024-07-01' = {
|
||||||
|
name: virtualMachineName
|
||||||
|
location: location
|
||||||
|
identity: {
|
||||||
|
type: 'SystemAssigned'
|
||||||
|
}
|
||||||
|
properties: {
|
||||||
|
hardwareProfile: {
|
||||||
|
vmSize: vmSize
|
||||||
|
}
|
||||||
|
securityProfile: {
|
||||||
|
securityType: 'TrustedLaunch'
|
||||||
|
uefiSettings: {
|
||||||
|
secureBootEnabled: true
|
||||||
|
vTpmEnabled: true
|
||||||
|
}
|
||||||
|
}
|
||||||
|
osProfile: {
|
||||||
|
computerName: computerName
|
||||||
|
adminUsername: administratorUsername
|
||||||
|
adminPassword: administratorPassword
|
||||||
|
windowsConfiguration: {
|
||||||
|
provisionVMAgent: true
|
||||||
|
enableAutomaticUpdates: true
|
||||||
|
patchSettings: {
|
||||||
|
patchMode: 'AutomaticByPlatform'
|
||||||
|
assessmentMode: 'AutomaticByPlatform'
|
||||||
|
enableHotpatching: false
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
storageProfile: {
|
||||||
|
imageReference: {
|
||||||
|
publisher: 'MicrosoftWindowsServer'
|
||||||
|
offer: 'WindowsServer'
|
||||||
|
sku: '2025-datacenter-azure-edition'
|
||||||
|
version: 'latest'
|
||||||
|
}
|
||||||
|
osDisk: {
|
||||||
|
createOption: 'FromImage'
|
||||||
|
// AD DS requires durable writes; the bootstrap stores NTDS on this disk.
|
||||||
|
caching: 'None'
|
||||||
|
managedDisk: {
|
||||||
|
storageAccountType: 'Premium_LRS'
|
||||||
|
}
|
||||||
|
deleteOption: 'Delete'
|
||||||
|
}
|
||||||
|
}
|
||||||
|
networkProfile: {
|
||||||
|
networkInterfaces: [
|
||||||
|
{
|
||||||
|
id: networkInterface.id
|
||||||
|
properties: {
|
||||||
|
primary: true
|
||||||
|
deleteOption: 'Delete'
|
||||||
|
}
|
||||||
|
}
|
||||||
|
]
|
||||||
|
}
|
||||||
|
diagnosticsProfile: {
|
||||||
|
bootDiagnostics: {
|
||||||
|
enabled: true
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
resource virtualNetworkGateway 'Microsoft.Network/virtualNetworkGateways@2024-05-01' = if (deployVpnGateway) {
|
||||||
|
name: virtualNetworkGatewayName
|
||||||
|
location: location
|
||||||
|
properties: {
|
||||||
|
gatewayType: 'Vpn'
|
||||||
|
vpnType: 'RouteBased'
|
||||||
|
activeActive: false
|
||||||
|
enableBgp: false
|
||||||
|
ipConfigurations: [
|
||||||
|
{
|
||||||
|
name: 'gateway-ipconfig'
|
||||||
|
properties: {
|
||||||
|
privateIPAllocationMethod: 'Dynamic'
|
||||||
|
subnet: {
|
||||||
|
id: resourceId('Microsoft.Network/virtualNetworks/subnets', virtualNetworkName, gatewaySubnetName)
|
||||||
|
}
|
||||||
|
publicIPAddress: {
|
||||||
|
id: gatewayPublicIp.id
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
]
|
||||||
|
sku: {
|
||||||
|
name: 'VpnGw1AZ'
|
||||||
|
tier: 'VpnGw1AZ'
|
||||||
|
}
|
||||||
|
vpnClientConfiguration: {
|
||||||
|
vpnClientAddressPool: {
|
||||||
|
addressPrefixes: [
|
||||||
|
vpnClientAddressPoolPrefix
|
||||||
|
]
|
||||||
|
}
|
||||||
|
vpnClientProtocols: [
|
||||||
|
'IkeV2'
|
||||||
|
'OpenVPN'
|
||||||
|
]
|
||||||
|
vpnAuthenticationTypes: [
|
||||||
|
'Certificate'
|
||||||
|
]
|
||||||
|
vpnClientRootCertificates: [
|
||||||
|
{
|
||||||
|
name: p2sRootCertificateName
|
||||||
|
properties: {
|
||||||
|
publicCertData: p2sRootCertificateData
|
||||||
|
}
|
||||||
|
}
|
||||||
|
]
|
||||||
|
}
|
||||||
|
}
|
||||||
|
dependsOn: [
|
||||||
|
virtualNetwork
|
||||||
|
]
|
||||||
|
}
|
||||||
|
|
||||||
|
output domainControllerName string = virtualMachine.name
|
||||||
|
output domainControllerPrivateIp string = domainControllerPrivateIp
|
||||||
|
output domainControllerPublicIp string = domainControllerPublicIp.properties.ipAddress
|
||||||
|
output virtualNetworkName string = virtualNetwork.name
|
||||||
|
output virtualNetworkAddressPrefix string = virtualNetworkAddressPrefix
|
||||||
|
output vpnGatewayName string = deployVpnGateway ? virtualNetworkGateway.name : ''
|
||||||
|
output vpnClientAddressPoolPrefix string = vpnClientAddressPoolPrefix
|
||||||
|
output userRoamingEnabled bool = deployUserRoaming
|
||||||
|
output userRoamingStorageAccountName string = deployUserRoaming ? userRoamingStorageAccount.name : ''
|
||||||
|
output fsLogixProfilesSharePath string = deployUserRoaming ? '\\\\${userRoamingStorageAccount.name}.file.${storageEndpointSuffix}\\${fsLogixProfilesShare.name}' : ''
|
||||||
|
output redirectedFoldersSharePath string = deployUserRoaming ? '\\\\${userRoamingStorageAccount.name}.file.${storageEndpointSuffix}\\${redirectedFoldersShare.name}' : ''
|
||||||
|
output userRoamingSetupArguments array = deployUserRoaming ? [
|
||||||
|
'-SubscriptionId'
|
||||||
|
subscription().subscriptionId
|
||||||
|
'-ResourceGroupName'
|
||||||
|
resourceGroup().name
|
||||||
|
'-StorageAccountName'
|
||||||
|
userRoamingStorageAccount.name
|
||||||
|
'-FsLogixProfilesShareName'
|
||||||
|
fsLogixProfilesShare.name
|
||||||
|
'-RedirectedFoldersShareName'
|
||||||
|
redirectedFoldersShare.name
|
||||||
|
] : []
|
||||||
|
output serverBootstrapArguments array = concat([
|
||||||
|
'-ServerIPv4Address'
|
||||||
|
domainControllerPrivateIp
|
||||||
|
'-PrefixLength'
|
||||||
|
last(split(domainControllerSubnetPrefix, '/'))
|
||||||
|
'-NetworkConfigurationMode'
|
||||||
|
'PlatformManaged'
|
||||||
|
'-DnsForwarders'
|
||||||
|
'168.63.129.16'
|
||||||
|
], deployVpnGateway ? [
|
||||||
|
'-TrustedClientNetworks'
|
||||||
|
vpnClientAddressPoolPrefix
|
||||||
|
] : [], empty(publicEnrollmentSourceAddressPrefixes) ? [] : concat([
|
||||||
|
'-PublicEnrollmentNetworks'
|
||||||
|
], publicEnrollmentSourceAddressPrefixes))
|
||||||
@@ -0,0 +1,122 @@
|
|||||||
|
[CmdletBinding()]
|
||||||
|
param(
|
||||||
|
[string]$ProfileName = 'Centro de Experiencia Digital',
|
||||||
|
[string]$Ssid = '',
|
||||||
|
[ValidateRange(1,30)][int]$TimeoutMinutes = 10,
|
||||||
|
[string]$FallbackProfile = '',
|
||||||
|
[string]$StatusPath = '',
|
||||||
|
[switch]$Force,
|
||||||
|
[switch]$RequireGroupPolicy
|
||||||
|
)
|
||||||
|
$ErrorActionPreference = 'Stop'
|
||||||
|
if (-not $Ssid) { $Ssid = $ProfileName }
|
||||||
|
# Connect to the already provisioned profile. Do not scan BSSIDs or change
|
||||||
|
# Windows location consent: those operations are unnecessary for this task.
|
||||||
|
if (-not ('Sgu.CedWlan' -as [type])) {
|
||||||
|
Add-Type -TypeDefinition @'
|
||||||
|
using System;
|
||||||
|
using System.Runtime.InteropServices;
|
||||||
|
namespace Sgu {
|
||||||
|
public static class CedWlan {
|
||||||
|
[StructLayout(LayoutKind.Sequential, CharSet=CharSet.Unicode)]
|
||||||
|
public struct Parameters {
|
||||||
|
public int Mode;
|
||||||
|
[MarshalAs(UnmanagedType.LPWStr)] public string Profile;
|
||||||
|
public IntPtr Ssid;
|
||||||
|
public IntPtr Bssids;
|
||||||
|
public int BssType;
|
||||||
|
public uint Flags;
|
||||||
|
}
|
||||||
|
[DllImport("wlanapi.dll")] static extern uint WlanOpenHandle(uint version,IntPtr reserved,out uint negotiated,out IntPtr handle);
|
||||||
|
[DllImport("wlanapi.dll")] static extern uint WlanEnumInterfaces(IntPtr handle,IntPtr reserved,out IntPtr list);
|
||||||
|
[DllImport("wlanapi.dll",CharSet=CharSet.Unicode)] static extern uint WlanConnect(IntPtr handle,ref Guid id,ref Parameters parameters,IntPtr reserved);
|
||||||
|
[DllImport("wlanapi.dll",CharSet=CharSet.Unicode)] static extern uint WlanGetProfile(IntPtr handle,ref Guid id,string profile,IntPtr reserved,out IntPtr xml,ref uint flags,out uint access);
|
||||||
|
[DllImport("wlanapi.dll",CharSet=CharSet.Unicode)] static extern uint WlanSetProfile(IntPtr handle,ref Guid id,uint flags,string xml,string security,[MarshalAs(UnmanagedType.Bool)] bool overwrite,IntPtr reserved,out uint reason);
|
||||||
|
[DllImport("wlanapi.dll")] static extern uint WlanCloseHandle(IntPtr handle,IntPtr reserved);
|
||||||
|
[DllImport("wlanapi.dll")] static extern void WlanFreeMemory(IntPtr memory);
|
||||||
|
static void Check(uint result) { if(result!=0) throw new System.ComponentModel.Win32Exception((int)result); }
|
||||||
|
public static void Connect(string profile, bool requireGroupPolicy) {
|
||||||
|
IntPtr handle=IntPtr.Zero, list=IntPtr.Zero; uint version;
|
||||||
|
Check(WlanOpenHandle(2,IntPtr.Zero,out version,out handle));
|
||||||
|
try {
|
||||||
|
Check(WlanEnumInterfaces(handle,IntPtr.Zero,out list));
|
||||||
|
int count=Marshal.ReadInt32(list);
|
||||||
|
if(count==0) throw new InvalidOperationException("No WLAN interfaces.");
|
||||||
|
for(int i=0;i<count;i++) {
|
||||||
|
Guid id=(Guid)Marshal.PtrToStructure(IntPtr.Add(list,8+i*532),typeof(Guid));
|
||||||
|
// GP's CSE can leave a Personal key unprotected. Let Native Wi-Fi
|
||||||
|
// encrypt it for this machine while retaining the GP profile type.
|
||||||
|
IntPtr xmlPointer=IntPtr.Zero; uint flags=0, access;
|
||||||
|
Check(WlanGetProfile(handle,ref id,profile,IntPtr.Zero,out xmlPointer,ref flags,out access));
|
||||||
|
try {
|
||||||
|
if(requireGroupPolicy && (flags & 1)==0) throw new InvalidOperationException("The requested profile is not managed by Group Policy.");
|
||||||
|
string xml=Marshal.PtrToStringUni(xmlPointer);
|
||||||
|
if((flags & 1)!=0 && xml.Contains("<protected>false</protected>")) {
|
||||||
|
uint reason; Check(WlanSetProfile(handle,ref id,1,xml,null,true,IntPtr.Zero,out reason));
|
||||||
|
}
|
||||||
|
} finally { if(xmlPointer!=IntPtr.Zero) WlanFreeMemory(xmlPointer); }
|
||||||
|
Parameters p=new Parameters { Mode=0,Profile=profile,BssType=1,Flags=0 };
|
||||||
|
Check(WlanConnect(handle,ref id,ref p,IntPtr.Zero));
|
||||||
|
}
|
||||||
|
} finally { if(list!=IntPtr.Zero) WlanFreeMemory(list); WlanCloseHandle(handle,IntPtr.Zero); }
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
'@
|
||||||
|
}
|
||||||
|
$start = Get-Date
|
||||||
|
$deadline = $start.AddMinutes($TimeoutMinutes)
|
||||||
|
function Write-Status([string]$Status, $Details) {
|
||||||
|
if ($StatusPath) {
|
||||||
|
[pscustomobject]@{Time=Get-Date;Profile=$ProfileName;Status=$Status;Details=$Details} |
|
||||||
|
ConvertTo-Json -Depth 4 | Set-Content -LiteralPath $StatusPath -Encoding UTF8
|
||||||
|
}
|
||||||
|
}
|
||||||
|
if (-not $Force) {
|
||||||
|
$liveSsid = @()
|
||||||
|
try {
|
||||||
|
$connections = [Windows.Networking.Connectivity.NetworkInformation,Windows.Networking.Connectivity,ContentType=WindowsRuntime]::GetConnectionProfiles()
|
||||||
|
$liveSsid = @($connections | Where-Object IsWlanConnectionProfile | ForEach-Object { $_.WlanConnectionProfileDetails.GetConnectedSsid() })
|
||||||
|
} catch { # An unavailable SSID API means we must verify a fresh connection event.
|
||||||
|
}
|
||||||
|
$latest = Get-WinEvent -FilterHashtable @{
|
||||||
|
LogName='Microsoft-Windows-WLAN-AutoConfig/Operational';Id=8001,8003
|
||||||
|
} -MaxEvents 1 -ErrorAction SilentlyContinue
|
||||||
|
if ($liveSsid -contains $Ssid -and $latest -and $latest.Id -eq 8001) {
|
||||||
|
[xml]$latestXml = $latest.ToXml()
|
||||||
|
$data = $latestXml.Event.EventData.Data
|
||||||
|
if (@($data | Where-Object { $_.Name -eq 'SSID' -and $_.'#text' -eq $Ssid }).Count -and
|
||||||
|
@($data | Where-Object { $_.Name -eq 'ProfileName' -and $_.'#text' -eq $ProfileName }).Count) {
|
||||||
|
Write-Status 'AlreadyConnected' $null
|
||||||
|
return
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
try {
|
||||||
|
do {
|
||||||
|
[Sgu.CedWlan]::Connect($ProfileName,[bool]$RequireGroupPolicy)
|
||||||
|
Start-Sleep -Seconds 10
|
||||||
|
$connected = Get-WinEvent -FilterHashtable @{
|
||||||
|
LogName='Microsoft-Windows-WLAN-AutoConfig/Operational';Id=8001;StartTime=$start
|
||||||
|
} -MaxEvents 20 -ErrorAction SilentlyContinue | Where-Object {
|
||||||
|
[xml]$eventXml = $_.ToXml()
|
||||||
|
$eventData = $eventXml.Event.EventData.Data
|
||||||
|
@($eventData | Where-Object { $_.Name -eq 'SSID' -and $_.'#text' -eq $Ssid }).Count -gt 0 -and
|
||||||
|
@($eventData | Where-Object { $_.Name -eq 'ProfileName' -and $_.'#text' -eq $ProfileName }).Count -gt 0
|
||||||
|
}
|
||||||
|
if ($connected) {
|
||||||
|
Register-DnsClient -ErrorAction SilentlyContinue
|
||||||
|
Write-Status 'Connected' $null
|
||||||
|
return
|
||||||
|
}
|
||||||
|
} while ((Get-Date) -lt $deadline)
|
||||||
|
$failures = @(Get-WinEvent -FilterHashtable @{
|
||||||
|
LogName='Microsoft-Windows-WLAN-AutoConfig/Operational';Id=8002;StartTime=$start
|
||||||
|
} -MaxEvents 3 -ErrorAction SilentlyContinue | ForEach-Object Message)
|
||||||
|
Write-Status 'Failed' $failures
|
||||||
|
throw "No successful WLAN connection event for '$ProfileName' within $TimeoutMinutes minutes."
|
||||||
|
} catch {
|
||||||
|
Write-Status 'Failed' $_.Exception.Message
|
||||||
|
if ($FallbackProfile) { [Sgu.CedWlan]::Connect($FallbackProfile,$false) }
|
||||||
|
throw
|
||||||
|
}
|
||||||
@@ -22,6 +22,8 @@ param(
|
|||||||
[ValidatePattern('^/')]
|
[ValidatePattern('^/')]
|
||||||
[string]$StudentProfilePath = '/psulsa/alumnos/consultainformacionalumnos/consultainformacion.aspx',
|
[string]$StudentProfilePath = '/psulsa/alumnos/consultainformacionalumnos/consultainformacion.aspx',
|
||||||
[ValidatePattern('^/')]
|
[ValidatePattern('^/')]
|
||||||
|
[string]$ProfessorPayrollProfilePath = '/psulsa/gadmon/nomina/consultanomina.aspx',
|
||||||
|
[ValidatePattern('^/')]
|
||||||
[string]$MenuProfilePath = '/psulsa/menu.aspx',
|
[string]$MenuProfilePath = '/psulsa/menu.aspx',
|
||||||
[ValidateRange(32768, 2097152)]
|
[ValidateRange(32768, 2097152)]
|
||||||
[int]$MaxProfileBytes = 524288,
|
[int]$MaxProfileBytes = 524288,
|
||||||
@@ -29,6 +31,9 @@ param(
|
|||||||
[string]$BaseDn = 'DC=lci,DC=lasalle,DC=mx',
|
[string]$BaseDn = 'DC=lci,DC=lasalle,DC=mx',
|
||||||
[string]$DomainNetbios = 'LCI',
|
[string]$DomainNetbios = 'LCI',
|
||||||
[string]$UpnSuffix = 'lci.lasalle.mx',
|
[string]$UpnSuffix = 'lci.lasalle.mx',
|
||||||
|
[string]$ProfessorGroupDn = '',
|
||||||
|
[string]$StudentGroupDn = '',
|
||||||
|
[string]$AdministrativeGroupDn = '',
|
||||||
[string]$RemoteDesktopGroupDn = '',
|
[string]$RemoteDesktopGroupDn = '',
|
||||||
[ValidateLength(1, 64)]
|
[ValidateLength(1, 64)]
|
||||||
[string]$DefaultCompany = 'La Salle',
|
[string]$DefaultCompany = 'La Salle',
|
||||||
@@ -46,6 +51,8 @@ param(
|
|||||||
$ErrorActionPreference = 'Stop'
|
$ErrorActionPreference = 'Stop'
|
||||||
$serviceName = 'SGUAuthBroker'
|
$serviceName = 'SGUAuthBroker'
|
||||||
$installPath = Join-Path $env:ProgramFiles 'SGU\AuthBroker'
|
$installPath = Join-Path $env:ProgramFiles 'SGU\AuthBroker'
|
||||||
|
$brokerEventLogName = 'SGU Auth Broker'
|
||||||
|
$brokerEventSource = 'SGU.AuthBroker.Operational'
|
||||||
$normalizedClientThumbprints = @($AllowedClientThumbprints | ForEach-Object { $_ -replace ' ', '' })
|
$normalizedClientThumbprints = @($AllowedClientThumbprints | ForEach-Object { $_ -replace ' ', '' })
|
||||||
if ($normalizedClientThumbprints.Where({ $_.Length -ne 40 }).Count -gt 0) {
|
if ($normalizedClientThumbprints.Where({ $_.Length -ne 40 }).Count -gt 0) {
|
||||||
throw 'Client certificate thumbprints must contain exactly 40 hexadecimal characters.'
|
throw 'Client certificate thumbprints must contain exactly 40 hexadecimal characters.'
|
||||||
@@ -68,10 +75,27 @@ if (-not $serverCertificate.Verify()) {
|
|||||||
throw 'The HTTPS server certificate chain is not trusted or is outside its validity period. Import the issuing CA chain; for a self-signed lab certificate, trust its public .cer in LocalMachine\Root.'
|
throw 'The HTTPS server certificate chain is not trusted or is outside its validity period. Import the issuing CA chain; for a self-signed lab certificate, trust its public .cer in LocalMachine\Root.'
|
||||||
}
|
}
|
||||||
|
|
||||||
|
Import-Module ActiveDirectory -ErrorAction Stop
|
||||||
|
|
||||||
|
function ConvertTo-LdapFilterValue {
|
||||||
|
param([Parameter(Mandatory)][string]$Value)
|
||||||
|
|
||||||
|
return $Value.Replace('\', '\5c').Replace('*', '\2a').Replace('(', '\28').Replace(')', '\29').Replace(([string][char]0), '\00')
|
||||||
|
}
|
||||||
|
|
||||||
|
$usersOuName = 'Usuarios-SGU'
|
||||||
|
$usersOuDn = "OU=$usersOuName,$BaseDn"
|
||||||
|
if ([string]::IsNullOrWhiteSpace($ProfessorGroupDn)) {
|
||||||
|
$ProfessorGroupDn = "CN=SGU-Docentes,OU=Docentes,$usersOuDn"
|
||||||
|
}
|
||||||
|
if ([string]::IsNullOrWhiteSpace($StudentGroupDn)) {
|
||||||
|
$StudentGroupDn = "CN=SGU-Alumnos,OU=Alumnos,$usersOuDn"
|
||||||
|
}
|
||||||
|
if ([string]::IsNullOrWhiteSpace($AdministrativeGroupDn)) {
|
||||||
|
$AdministrativeGroupDn = "CN=SGU-Administrativos,OU=Administrativos,$usersOuDn"
|
||||||
|
}
|
||||||
|
|
||||||
if ($CreateMissingOus) {
|
if ($CreateMissingOus) {
|
||||||
Import-Module ActiveDirectory -ErrorAction Stop
|
|
||||||
$usersOuName = 'Usuarios-SGU'
|
|
||||||
$usersOuDn = "OU=$usersOuName,$BaseDn"
|
|
||||||
if (-not (Get-ADOrganizationalUnit -LDAPFilter "(ou=$usersOuName)" -SearchBase $BaseDn -SearchScope OneLevel -Server $LdapHost -ErrorAction SilentlyContinue)) {
|
if (-not (Get-ADOrganizationalUnit -LDAPFilter "(ou=$usersOuName)" -SearchBase $BaseDn -SearchScope OneLevel -Server $LdapHost -ErrorAction SilentlyContinue)) {
|
||||||
New-ADOrganizationalUnit -Name $usersOuName -Path $BaseDn -ProtectedFromAccidentalDeletion $true -Server $LdapHost | Out-Null
|
New-ADOrganizationalUnit -Name $usersOuName -Path $BaseDn -ProtectedFromAccidentalDeletion $true -Server $LdapHost | Out-Null
|
||||||
}
|
}
|
||||||
@@ -113,8 +137,63 @@ if ($CreateMissingOus) {
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
$roleGroupDefinitions = @(
|
||||||
|
[pscustomobject]@{ Role = 'Professor'; Dn = $ProfessorGroupDn; Description = 'SGU accounts with the DO institutional prefix.' }
|
||||||
|
[pscustomobject]@{ Role = 'Student'; Dn = $StudentGroupDn; Description = 'SGU accounts with the AL institutional prefix.' }
|
||||||
|
[pscustomobject]@{ Role = 'Administrative'; Dn = $AdministrativeGroupDn; Description = 'SGU accounts with the AD institutional prefix.' }
|
||||||
|
)
|
||||||
|
foreach ($definition in $roleGroupDefinitions) {
|
||||||
|
if (-not $definition.Dn.EndsWith(",$BaseDn", [StringComparison]::OrdinalIgnoreCase)) {
|
||||||
|
throw "$($definition.Role)GroupDn must identify a security group beneath BaseDn."
|
||||||
|
}
|
||||||
|
|
||||||
|
try {
|
||||||
|
$roleGroup = Get-ADGroup -Identity $definition.Dn -Server $LdapHost -ErrorAction Stop
|
||||||
|
}
|
||||||
|
catch [Microsoft.ActiveDirectory.Management.ADIdentityNotFoundException] {
|
||||||
|
$roleGroup = $null
|
||||||
|
}
|
||||||
|
if (-not $roleGroup -and $CreateMissingOus) {
|
||||||
|
$groupDnMatch = [regex]::Match($definition.Dn, '^CN=(?<Name>[^,]+),(?<Path>.+)$', [Text.RegularExpressions.RegexOptions]::IgnoreCase)
|
||||||
|
if (-not $groupDnMatch.Success) {
|
||||||
|
throw "$($definition.Role)GroupDn must start with a simple CN component."
|
||||||
|
}
|
||||||
|
$groupName = $groupDnMatch.Groups['Name'].Value
|
||||||
|
$groupPath = $groupDnMatch.Groups['Path'].Value
|
||||||
|
if ($groupName.Length -gt 20) {
|
||||||
|
throw "$($definition.Role) group name exceeds the 20-character sAMAccountName limit."
|
||||||
|
}
|
||||||
|
|
||||||
|
$matchingGroups = @(Get-ADGroup `
|
||||||
|
-LDAPFilter "(sAMAccountName=$(ConvertTo-LdapFilterValue -Value $groupName))" `
|
||||||
|
-SearchBase $BaseDn -SearchScope Subtree -Server $LdapHost -ErrorAction Stop)
|
||||||
|
if ($matchingGroups.Count -gt 1) {
|
||||||
|
throw "More than one Active Directory group uses sAMAccountName $groupName; the bootstrap cannot select one safely."
|
||||||
|
}
|
||||||
|
if ($matchingGroups.Count -eq 1) {
|
||||||
|
if ($matchingGroups[0].GroupCategory -ne 'Security') {
|
||||||
|
throw "$($definition.Role)GroupDn must identify a security group."
|
||||||
|
}
|
||||||
|
Move-ADObject -Identity $matchingGroups[0].DistinguishedName `
|
||||||
|
-TargetPath $groupPath -Server $LdapHost -Confirm:$false -ErrorAction Stop
|
||||||
|
}
|
||||||
|
else {
|
||||||
|
New-ADGroup -Name $groupName -SamAccountName $groupName `
|
||||||
|
-GroupCategory Security -GroupScope Global `
|
||||||
|
-Path $groupPath `
|
||||||
|
-Description $definition.Description -Server $LdapHost | Out-Null
|
||||||
|
}
|
||||||
|
$roleGroup = Get-ADGroup -Identity $definition.Dn -Server $LdapHost -ErrorAction Stop
|
||||||
|
}
|
||||||
|
if (-not $roleGroup) {
|
||||||
|
throw "The required $($definition.Role) security group does not exist: $($definition.Dn)"
|
||||||
|
}
|
||||||
|
if ($roleGroup.GroupCategory -ne 'Security') {
|
||||||
|
throw "$($definition.Role)GroupDn must identify a security group."
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
if ($RemoteDesktopGroupDn) {
|
if ($RemoteDesktopGroupDn) {
|
||||||
Import-Module ActiveDirectory -ErrorAction Stop
|
|
||||||
$remoteDesktopGroup = Get-ADGroup -Identity $RemoteDesktopGroupDn -Server $LdapHost -ErrorAction Stop
|
$remoteDesktopGroup = Get-ADGroup -Identity $RemoteDesktopGroupDn -Server $LdapHost -ErrorAction Stop
|
||||||
if ($remoteDesktopGroup.GroupCategory -ne 'Security' -or
|
if ($remoteDesktopGroup.GroupCategory -ne 'Security' -or
|
||||||
-not $remoteDesktopGroup.DistinguishedName.EndsWith(",$BaseDn", [StringComparison]::OrdinalIgnoreCase)) {
|
-not $remoteDesktopGroup.DistinguishedName.EndsWith(",$BaseDn", [StringComparison]::OrdinalIgnoreCase)) {
|
||||||
@@ -122,6 +201,37 @@ if ($RemoteDesktopGroupDn) {
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
$managedUsersPasswordChangeCorrected = 0
|
||||||
|
$managedUsersReversibleEncryptionDisabled = 0
|
||||||
|
$sguRoleGroupDns = @($ProfessorGroupDn, $StudentGroupDn, $AdministrativeGroupDn)
|
||||||
|
$sguRoleUserDns = [Collections.Generic.HashSet[string]]::new([StringComparer]::OrdinalIgnoreCase)
|
||||||
|
foreach ($roleGroupDn in $sguRoleGroupDns) {
|
||||||
|
foreach ($member in Get-ADGroupMember -Identity $roleGroupDn -Recursive `
|
||||||
|
-Server $LdapHost -ErrorAction Stop) {
|
||||||
|
if ($member.objectClass -eq 'user') {
|
||||||
|
[void]$sguRoleUserDns.Add($member.DistinguishedName)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
if ($PSCmdlet.ShouldProcess($usersOuDn, 'Deny direct password changes for every managed SGU user')) {
|
||||||
|
$managedUsers = @(Get-ADUser -Filter * -SearchBase $usersOuDn -SearchScope Subtree `
|
||||||
|
-Properties CannotChangePassword,AllowReversiblePasswordEncryption `
|
||||||
|
-Server $LdapHost -ErrorAction Stop)
|
||||||
|
foreach ($managedUser in $managedUsers) {
|
||||||
|
if (-not $managedUser.CannotChangePassword) {
|
||||||
|
Set-ADAccountControl -Identity $managedUser.DistinguishedName `
|
||||||
|
-CannotChangePassword $true -Server $LdapHost -Confirm:$false
|
||||||
|
$managedUsersPasswordChangeCorrected++
|
||||||
|
}
|
||||||
|
if ($sguRoleUserDns.Contains($managedUser.DistinguishedName) -and
|
||||||
|
$managedUser.AllowReversiblePasswordEncryption) {
|
||||||
|
Set-ADAccountControl -Identity $managedUser.DistinguishedName `
|
||||||
|
-AllowReversiblePasswordEncryption $false -Server $LdapHost -Confirm:$false
|
||||||
|
$managedUsersReversibleEncryptionDisabled++
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
foreach ($file in @('SGU.AuthBroker.exe', 'SGU.AuthBroker.dll', 'appsettings.json')) {
|
foreach ($file in @('SGU.AuthBroker.exe', 'SGU.AuthBroker.dll', 'appsettings.json')) {
|
||||||
if (-not (Test-Path -LiteralPath (Join-Path $PublishPath $file))) {
|
if (-not (Test-Path -LiteralPath (Join-Path $PublishPath $file))) {
|
||||||
throw "PublishPath is missing $file."
|
throw "PublishPath is missing $file."
|
||||||
@@ -129,6 +239,14 @@ foreach ($file in @('SGU.AuthBroker.exe', 'SGU.AuthBroker.dll', 'appsettings.jso
|
|||||||
}
|
}
|
||||||
|
|
||||||
$productionSettings = @{
|
$productionSettings = @{
|
||||||
|
Logging = @{
|
||||||
|
EventLog = @{
|
||||||
|
LogLevel = @{
|
||||||
|
Default = 'Information'
|
||||||
|
'Microsoft.AspNetCore' = 'Warning'
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
Kestrel = @{
|
Kestrel = @{
|
||||||
Endpoints = @{
|
Endpoints = @{
|
||||||
Https = @{
|
Https = @{
|
||||||
@@ -143,6 +261,9 @@ $productionSettings = @{
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
Broker = @{
|
Broker = @{
|
||||||
|
Diagnostics = @{
|
||||||
|
UseDedicatedEventLog = $true
|
||||||
|
}
|
||||||
Tls = @{
|
Tls = @{
|
||||||
AllowedClientThumbprints = $normalizedClientThumbprints
|
AllowedClientThumbprints = $normalizedClientThumbprints
|
||||||
CheckCertificateRevocation = -not $DisableCertificateRevocationCheckForLab
|
CheckCertificateRevocation = -not $DisableCertificateRevocationCheckForLab
|
||||||
@@ -158,6 +279,7 @@ $productionSettings = @{
|
|||||||
AdministrativePersonalProfilePath = $AdministrativePersonalProfilePath
|
AdministrativePersonalProfilePath = $AdministrativePersonalProfilePath
|
||||||
AdministrativeLocationProfilePath = $AdministrativeLocationProfilePath
|
AdministrativeLocationProfilePath = $AdministrativeLocationProfilePath
|
||||||
StudentProfilePath = $StudentProfilePath
|
StudentProfilePath = $StudentProfilePath
|
||||||
|
ProfessorPayrollProfilePath = $ProfessorPayrollProfilePath
|
||||||
MenuProfilePath = $MenuProfilePath
|
MenuProfilePath = $MenuProfilePath
|
||||||
MaxProfileBytes = $MaxProfileBytes
|
MaxProfileBytes = $MaxProfileBytes
|
||||||
AllowedRedirectHosts = $AllowedNtlmRedirectHosts
|
AllowedRedirectHosts = $AllowedNtlmRedirectHosts
|
||||||
@@ -170,6 +292,9 @@ $productionSettings = @{
|
|||||||
ProfessorOuDn = "OU=Docentes,OU=Usuarios-SGU,$BaseDn"
|
ProfessorOuDn = "OU=Docentes,OU=Usuarios-SGU,$BaseDn"
|
||||||
StudentOuDn = "OU=Alumnos,OU=Usuarios-SGU,$BaseDn"
|
StudentOuDn = "OU=Alumnos,OU=Usuarios-SGU,$BaseDn"
|
||||||
AdministrativeOuDn = "OU=Administrativos,OU=Usuarios-SGU,$BaseDn"
|
AdministrativeOuDn = "OU=Administrativos,OU=Usuarios-SGU,$BaseDn"
|
||||||
|
ProfessorGroupDn = $ProfessorGroupDn
|
||||||
|
StudentGroupDn = $StudentGroupDn
|
||||||
|
AdministrativeGroupDn = $AdministrativeGroupDn
|
||||||
RemoteDesktopGroupDn = $RemoteDesktopGroupDn
|
RemoteDesktopGroupDn = $RemoteDesktopGroupDn
|
||||||
DefaultCompany = $DefaultCompany
|
DefaultCompany = $DefaultCompany
|
||||||
CreateMissingOus = [bool]$CreateMissingOus
|
CreateMissingOus = [bool]$CreateMissingOus
|
||||||
@@ -198,6 +323,18 @@ if ($PSCmdlet.ShouldProcess($installPath, 'Install the SGU Authentication Broker
|
|||||||
$settingsJson,
|
$settingsJson,
|
||||||
$utf8WithoutBom)
|
$utf8WithoutBom)
|
||||||
|
|
||||||
|
if ([Diagnostics.EventLog]::SourceExists($brokerEventSource)) {
|
||||||
|
$registeredLog = [Diagnostics.EventLog]::LogNameFromSourceName($brokerEventSource, '.')
|
||||||
|
if (-not $registeredLog.Equals($brokerEventLogName, [StringComparison]::OrdinalIgnoreCase)) {
|
||||||
|
throw "Event source $brokerEventSource is already registered to $registeredLog."
|
||||||
|
}
|
||||||
|
}
|
||||||
|
else {
|
||||||
|
New-EventLog -LogName $brokerEventLogName -Source $brokerEventSource
|
||||||
|
}
|
||||||
|
Limit-EventLog -LogName $brokerEventLogName -MaximumSize 268435456 `
|
||||||
|
-OverflowAction OverwriteAsNeeded
|
||||||
|
|
||||||
if (-not (Get-Service -Name $serviceName -ErrorAction SilentlyContinue)) {
|
if (-not (Get-Service -Name $serviceName -ErrorAction SilentlyContinue)) {
|
||||||
New-Service -Name $serviceName `
|
New-Service -Name $serviceName `
|
||||||
-DisplayName 'SGU Authentication Broker' `
|
-DisplayName 'SGU Authentication Broker' `
|
||||||
@@ -249,4 +386,7 @@ if ($PSCmdlet.ShouldProcess($installPath, 'Install the SGU Authentication Broker
|
|||||||
Start-Service -Name $serviceName
|
Start-Service -Name $serviceName
|
||||||
}
|
}
|
||||||
|
|
||||||
Get-Service -Name $serviceName | Select-Object Name, Status, StartType
|
Get-Service -Name $serviceName | Select-Object Name, Status, StartType,
|
||||||
|
@{ Name = 'EventLog'; Expression = { $brokerEventLogName } },
|
||||||
|
@{ Name = 'ExistingUsersPasswordChangeDenied'; Expression = { $managedUsersPasswordChangeCorrected } },
|
||||||
|
@{ Name = 'ExistingSguRoleUsersReversibleEncryptionDisabled'; Expression = { $managedUsersReversibleEncryptionDisabled } }
|
||||||
@@ -0,0 +1,196 @@
|
|||||||
|
#Requires -Version 5.1
|
||||||
|
[CmdletBinding(SupportsShouldProcess)]
|
||||||
|
param(
|
||||||
|
[Parameter(Mandatory)][string]$SubscriptionId,
|
||||||
|
[string]$ResourceGroupName = 'rg-sgu-lab',
|
||||||
|
[string]$Location = 'centralus',
|
||||||
|
[string]$DeploymentPrefix = 'sgu-lab',
|
||||||
|
[Parameter(Mandatory)][string]$AdministratorUsername,
|
||||||
|
[securestring]$AdministratorPassword,
|
||||||
|
[string]$P2sRootCertificatePath,
|
||||||
|
[bool]$DeployVpnGateway = $true,
|
||||||
|
[string]$ComputerName = 'SGU-DC01',
|
||||||
|
[string]$VmSize = 'Standard_D2s_v5',
|
||||||
|
[string]$VirtualNetworkAddressPrefix = '10.77.0.0/16',
|
||||||
|
[string]$DomainControllerSubnetPrefix = '10.77.0.0/24',
|
||||||
|
[ipaddress]$DomainControllerPrivateIp = '10.77.0.4',
|
||||||
|
[string]$GatewaySubnetPrefix = '10.77.255.0/27',
|
||||||
|
[string]$VpnClientAddressPoolPrefix = '172.30.0.0/24',
|
||||||
|
[string[]]$PublicEnrollmentSourceAddressPrefixes = @(),
|
||||||
|
[string]$AdministratorSourceAddressPrefix = '',
|
||||||
|
[bool]$DeployUserRoaming = $false,
|
||||||
|
[switch]$AcknowledgeUserRoamingRisks,
|
||||||
|
[ValidatePattern('^$|^[a-z0-9]{3,24}$')]
|
||||||
|
[string]$UserRoamingStorageAccountName = '',
|
||||||
|
[ValidatePattern('^[a-z0-9](?:[a-z0-9-]{1,61}[a-z0-9])$')]
|
||||||
|
[string]$FsLogixProfilesShareName = 'profiles',
|
||||||
|
[ValidatePattern('^[a-z0-9](?:[a-z0-9-]{1,61}[a-z0-9])$')]
|
||||||
|
[string]$RedirectedFoldersShareName = 'redirected',
|
||||||
|
[ValidateRange(100, 102400)]
|
||||||
|
[int]$FsLogixProfilesQuotaGiB = 1024,
|
||||||
|
[ValidateRange(100, 102400)]
|
||||||
|
[int]$RedirectedFoldersQuotaGiB = 1024,
|
||||||
|
[string]$TemplateFile = (Join-Path $PSScriptRoot '..\infra\azure\main.bicep')
|
||||||
|
)
|
||||||
|
|
||||||
|
$ErrorActionPreference = 'Stop'
|
||||||
|
$ProgressPreference = 'SilentlyContinue'
|
||||||
|
|
||||||
|
if (-not (Get-Command az -ErrorAction SilentlyContinue)) {
|
||||||
|
throw 'Azure CLI is required. Install it from https://aka.ms/installazurecliwindows and run az login.'
|
||||||
|
}
|
||||||
|
if (-not (Test-Path -LiteralPath $TemplateFile -PathType Leaf)) {
|
||||||
|
throw "Azure Bicep template not found: $TemplateFile"
|
||||||
|
}
|
||||||
|
if (-not $AdministratorPassword) {
|
||||||
|
$AdministratorPassword = Read-Host 'Password for the local Azure VM administrator' -AsSecureString
|
||||||
|
}
|
||||||
|
if ($DeployUserRoaming -and -not $DeployVpnGateway) {
|
||||||
|
throw 'Azure user roaming requires the P2S gateway deployed by this template so clients can reach the private Azure Files endpoint. Use -DeployUserRoaming $false with direct public enrollment.'
|
||||||
|
}
|
||||||
|
if ($DeployUserRoaming -and -not $AcknowledgeUserRoamingRisks) {
|
||||||
|
throw 'User roaming is disabled by default. To provision it, also pass -AcknowledgeUserRoamingRisks after reviewing the sign-in, sign-out, storage-availability, stale-cache, and recovery risks in docs/user-roaming.md.'
|
||||||
|
}
|
||||||
|
foreach ($shareName in @($FsLogixProfilesShareName, $RedirectedFoldersShareName)) {
|
||||||
|
if ($shareName.Contains('--')) {
|
||||||
|
throw "Azure Files share names cannot contain consecutive hyphens: $shareName"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
if ($FsLogixProfilesShareName -eq $RedirectedFoldersShareName) {
|
||||||
|
throw 'FsLogixProfilesShareName and RedirectedFoldersShareName must be different.'
|
||||||
|
}
|
||||||
|
|
||||||
|
$rootCertificateData = ''
|
||||||
|
if ($DeployVpnGateway) {
|
||||||
|
if (-not $P2sRootCertificatePath -or
|
||||||
|
-not (Test-Path -LiteralPath $P2sRootCertificatePath -PathType Leaf)) {
|
||||||
|
throw 'P2sRootCertificatePath is required when DeployVpnGateway is true.'
|
||||||
|
}
|
||||||
|
$rootCertificate = [Security.Cryptography.X509Certificates.X509Certificate2]::new(
|
||||||
|
(Resolve-Path -LiteralPath $P2sRootCertificatePath).Path)
|
||||||
|
if (-not ($rootCertificate.Extensions | Where-Object {
|
||||||
|
$_.Oid -and $_.Oid.Value -eq '2.5.29.19' -and $_.Format($false) -match 'CA' })) {
|
||||||
|
throw 'P2sRootCertificatePath must contain a certificate-authority certificate.'
|
||||||
|
}
|
||||||
|
$rootCertificateData = [Convert]::ToBase64String($rootCertificate.RawData)
|
||||||
|
}
|
||||||
|
|
||||||
|
$account = & az account show --output json 2>$null
|
||||||
|
if ($LASTEXITCODE -ne 0) {
|
||||||
|
throw 'Azure CLI is not signed in. Run az login, then retry.'
|
||||||
|
}
|
||||||
|
& az account set --subscription $SubscriptionId --only-show-errors
|
||||||
|
if ($LASTEXITCODE -ne 0) {
|
||||||
|
throw "Could not select Azure subscription $SubscriptionId."
|
||||||
|
}
|
||||||
|
|
||||||
|
$deploymentDescription = if ($DeployVpnGateway -and $DeployUserRoaming) {
|
||||||
|
'Create Azure VNet, Windows Server 2025 VM, public IP, P2S VPN Gateway, and private user-roaming storage'
|
||||||
|
}
|
||||||
|
elseif ($DeployVpnGateway) {
|
||||||
|
'Create Azure VNet, Windows Server 2025 VM, public IP, and P2S VPN Gateway'
|
||||||
|
}
|
||||||
|
else {
|
||||||
|
'Create Azure VNet, Windows Server 2025 VM, and public IP for direct enrollment'
|
||||||
|
}
|
||||||
|
if ($PSCmdlet.ShouldProcess("$ResourceGroupName in $Location", $deploymentDescription)) {
|
||||||
|
& az group create --name $ResourceGroupName --location $Location --only-show-errors --output none
|
||||||
|
if ($LASTEXITCODE -ne 0) {
|
||||||
|
throw "Could not create or update resource group $ResourceGroupName."
|
||||||
|
}
|
||||||
|
|
||||||
|
$temporaryRoot = Join-Path ([IO.Path]::GetTempPath()) ("sgu-azure-" + [Guid]::NewGuid().ToString('N'))
|
||||||
|
$parametersPath = Join-Path $temporaryRoot 'parameters.json'
|
||||||
|
$passwordPointer = [Runtime.InteropServices.Marshal]::SecureStringToBSTR($AdministratorPassword)
|
||||||
|
try {
|
||||||
|
New-Item -ItemType Directory -Path $temporaryRoot -Force | Out-Null
|
||||||
|
$acl = Get-Acl -LiteralPath $temporaryRoot
|
||||||
|
$acl.SetAccessRuleProtection($true, $false)
|
||||||
|
$acl.AddAccessRule([Security.AccessControl.FileSystemAccessRule]::new(
|
||||||
|
[Security.Principal.WindowsIdentity]::GetCurrent().User,
|
||||||
|
[Security.AccessControl.FileSystemRights]::FullControl,
|
||||||
|
[Security.AccessControl.InheritanceFlags]'ContainerInherit,ObjectInherit',
|
||||||
|
[Security.AccessControl.PropagationFlags]::None,
|
||||||
|
[Security.AccessControl.AccessControlType]::Allow))
|
||||||
|
Set-Acl -LiteralPath $temporaryRoot -AclObject $acl
|
||||||
|
|
||||||
|
$plainPassword = [Runtime.InteropServices.Marshal]::PtrToStringBSTR($passwordPointer)
|
||||||
|
$parameters = [ordered]@{
|
||||||
|
'$schema' = 'https://schema.management.azure.com/schemas/2019-04-01/deploymentParameters.json#'
|
||||||
|
contentVersion = '1.0.0.0'
|
||||||
|
parameters = [ordered]@{
|
||||||
|
deploymentPrefix = @{ value = $DeploymentPrefix }
|
||||||
|
location = @{ value = $Location }
|
||||||
|
administratorUsername = @{ value = $AdministratorUsername }
|
||||||
|
administratorPassword = @{ value = $plainPassword }
|
||||||
|
computerName = @{ value = $ComputerName }
|
||||||
|
vmSize = @{ value = $VmSize }
|
||||||
|
virtualNetworkAddressPrefix = @{ value = $VirtualNetworkAddressPrefix }
|
||||||
|
domainControllerSubnetPrefix = @{ value = $DomainControllerSubnetPrefix }
|
||||||
|
gatewaySubnetPrefix = @{ value = $GatewaySubnetPrefix }
|
||||||
|
domainControllerPrivateIp = @{ value = $DomainControllerPrivateIp.IPAddressToString }
|
||||||
|
vpnClientAddressPoolPrefix = @{ value = $VpnClientAddressPoolPrefix }
|
||||||
|
deployVpnGateway = @{ value = $DeployVpnGateway }
|
||||||
|
p2sRootCertificateData = @{ value = $rootCertificateData }
|
||||||
|
publicEnrollmentSourceAddressPrefixes = @{ value = @($PublicEnrollmentSourceAddressPrefixes) }
|
||||||
|
administratorSourceAddressPrefix = @{ value = $AdministratorSourceAddressPrefix }
|
||||||
|
deployUserRoaming = @{ value = $DeployUserRoaming }
|
||||||
|
userRoamingStorageAccountName = @{ value = $UserRoamingStorageAccountName }
|
||||||
|
fsLogixProfilesShareName = @{ value = $FsLogixProfilesShareName }
|
||||||
|
redirectedFoldersShareName = @{ value = $RedirectedFoldersShareName }
|
||||||
|
fsLogixProfilesQuotaGiB = @{ value = $FsLogixProfilesQuotaGiB }
|
||||||
|
redirectedFoldersQuotaGiB = @{ value = $RedirectedFoldersQuotaGiB }
|
||||||
|
}
|
||||||
|
}
|
||||||
|
[IO.File]::WriteAllText(
|
||||||
|
$parametersPath,
|
||||||
|
($parameters | ConvertTo-Json -Depth 8),
|
||||||
|
[Text.UTF8Encoding]::new($false))
|
||||||
|
$plainPassword = $null
|
||||||
|
$parameters.parameters.administratorPassword.value = $null
|
||||||
|
|
||||||
|
$deploymentName = 'sgu-{0}' -f (Get-Date -Format 'yyyyMMdd-HHmmss')
|
||||||
|
$deploymentOutput = & az deployment group create `
|
||||||
|
--name $deploymentName `
|
||||||
|
--resource-group $ResourceGroupName `
|
||||||
|
--template-file (Resolve-Path -LiteralPath $TemplateFile).Path `
|
||||||
|
--parameters "@$parametersPath" `
|
||||||
|
--only-show-errors `
|
||||||
|
--output json
|
||||||
|
if ($LASTEXITCODE -ne 0) {
|
||||||
|
throw 'Azure deployment failed. Review the Azure CLI error above; no bootstrap credential was persisted by this script.'
|
||||||
|
}
|
||||||
|
$deployment = ($deploymentOutput -join [Environment]::NewLine) | ConvertFrom-Json
|
||||||
|
}
|
||||||
|
finally {
|
||||||
|
if ($passwordPointer -ne [IntPtr]::Zero) {
|
||||||
|
[Runtime.InteropServices.Marshal]::ZeroFreeBSTR($passwordPointer)
|
||||||
|
}
|
||||||
|
$AdministratorPassword = $null
|
||||||
|
if ($temporaryRoot -and (Test-Path -LiteralPath $temporaryRoot)) {
|
||||||
|
Remove-Item -LiteralPath $temporaryRoot -Recurse -Force -ErrorAction SilentlyContinue
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
$values = @{}
|
||||||
|
foreach ($property in $deployment.properties.outputs.PSObject.Properties) {
|
||||||
|
$values[$property.Name] = $property.Value.value
|
||||||
|
}
|
||||||
|
[pscustomobject]@{
|
||||||
|
ResourceGroupName = $ResourceGroupName
|
||||||
|
DeploymentName = $deploymentName
|
||||||
|
DomainControllerName = $values.domainControllerName
|
||||||
|
DomainControllerPrivateIp = $values.domainControllerPrivateIp
|
||||||
|
DomainControllerPublicIp = $values.domainControllerPublicIp
|
||||||
|
VpnGatewayName = $values.vpnGatewayName
|
||||||
|
VpnClientAddressPoolPrefix = $values.vpnClientAddressPoolPrefix
|
||||||
|
DeployVpnGateway = $DeployVpnGateway
|
||||||
|
PublicEnrollmentSourceAddressPrefixes = @($PublicEnrollmentSourceAddressPrefixes)
|
||||||
|
ServerBootstrapArguments = $values.serverBootstrapArguments
|
||||||
|
UserRoamingEnabled = [bool]$values.userRoamingEnabled
|
||||||
|
UserRoamingStorageAccountName = $values.userRoamingStorageAccountName
|
||||||
|
FsLogixProfilesSharePath = $values.fsLogixProfilesSharePath
|
||||||
|
RedirectedFoldersSharePath = $values.redirectedFoldersSharePath
|
||||||
|
UserRoamingSetupArguments = @($values.userRoamingSetupArguments)
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,210 @@
|
|||||||
|
#Requires -Version 5.1
|
||||||
|
[CmdletBinding(SupportsShouldProcess)]
|
||||||
|
param(
|
||||||
|
[string]$DomainController = $env:COMPUTERNAME,
|
||||||
|
[string]$StudentOuName = 'Alumnos',
|
||||||
|
[string]$ProfessorOuName = 'Docentes',
|
||||||
|
[string]$AdministrativeOuName = 'Administrativos',
|
||||||
|
[string]$LaboratoryOuName = 'Laboratorio',
|
||||||
|
[string]$StudentGroupName = 'SGU-Alumnos',
|
||||||
|
[string]$ProfessorGroupName = 'SGU-Docentes',
|
||||||
|
[string]$AdministrativeGroupName = 'SGU-Administrativos',
|
||||||
|
[string]$StudentGpoName = 'SGU - AL redirected folders',
|
||||||
|
[string]$StaffGpoName = 'SGU - AD-DO FSLogix profiles',
|
||||||
|
[string]$FsLogixDeploymentGpoName = 'SGU - FSLogix client deployment',
|
||||||
|
[switch]$PreserveLegacyUserMappings
|
||||||
|
)
|
||||||
|
|
||||||
|
$ErrorActionPreference = 'Stop'
|
||||||
|
|
||||||
|
function Assert-Administrator {
|
||||||
|
$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 5.1 session on the SGU domain controller.'
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
function Set-SguPolicyValue {
|
||||||
|
param(
|
||||||
|
[Parameter(Mandatory)][string]$GpoName,
|
||||||
|
[Parameter(Mandatory)][string]$DomainName,
|
||||||
|
[Parameter(Mandatory)][string]$Server,
|
||||||
|
[Parameter(Mandatory)][string]$Key,
|
||||||
|
[Parameter(Mandatory)][string]$ValueName,
|
||||||
|
[Parameter(Mandatory)][ValidateSet('DWord','String','ExpandString')][string]$Type,
|
||||||
|
[Parameter(Mandatory)]$Value
|
||||||
|
)
|
||||||
|
if ($PSCmdlet.ShouldProcess("$GpoName :: $Key\\$ValueName", "Set rollback value $Value")) {
|
||||||
|
Remove-GPRegistryValue -Name $GpoName -Domain $DomainName -Server $Server `
|
||||||
|
-Key $Key -ValueName "**del.$ValueName" -ErrorAction SilentlyContinue | Out-Null
|
||||||
|
Set-GPRegistryValue -Name $GpoName -Domain $DomainName -Server $Server `
|
||||||
|
-Key $Key -ValueName $ValueName -Type $Type -Value $Value | Out-Null
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
function Remove-SguPolicyValue {
|
||||||
|
param(
|
||||||
|
[Parameter(Mandatory)][string]$GpoName,
|
||||||
|
[Parameter(Mandatory)][string]$DomainName,
|
||||||
|
[Parameter(Mandatory)][string]$Server,
|
||||||
|
[Parameter(Mandatory)][string]$Key,
|
||||||
|
[Parameter(Mandatory)][string]$ValueName
|
||||||
|
)
|
||||||
|
if ($PSCmdlet.ShouldProcess("$GpoName :: $Key\\$ValueName", 'Remove roaming value')) {
|
||||||
|
Remove-GPRegistryValue -Name $GpoName -Domain $DomainName -Server $Server `
|
||||||
|
-Key $Key -ValueName $ValueName -ErrorAction SilentlyContinue | Out-Null
|
||||||
|
Set-GPRegistryValue -Name $GpoName -Domain $DomainName -Server $Server `
|
||||||
|
-Key $Key -ValueName "**del.$ValueName" -Type String -Value '' | Out-Null
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
Assert-Administrator
|
||||||
|
Import-Module ActiveDirectory -ErrorAction Stop
|
||||||
|
Import-Module GroupPolicy -ErrorAction Stop
|
||||||
|
|
||||||
|
$domain = Get-ADDomain -Server $DomainController
|
||||||
|
$domainName = $domain.DNSRoot
|
||||||
|
$domainDn = $domain.DistinguishedName
|
||||||
|
$laboratoryOuDn = "OU=$LaboratoryOuName,$domainDn"
|
||||||
|
$usersOuDn = "OU=Usuarios-SGU,$domainDn"
|
||||||
|
$studentOuDn = "OU=$StudentOuName,$usersOuDn"
|
||||||
|
$professorOuDn = "OU=$ProfessorOuName,$usersOuDn"
|
||||||
|
$administrativeOuDn = "OU=$AdministrativeOuName,$usersOuDn"
|
||||||
|
|
||||||
|
foreach ($ou in $laboratoryOuDn,$studentOuDn,$professorOuDn,$administrativeOuDn) {
|
||||||
|
Get-ADOrganizationalUnit -Identity $ou -Server $DomainController -ErrorAction Stop | Out-Null
|
||||||
|
}
|
||||||
|
|
||||||
|
$staffGpo = Get-GPO -Name $StaffGpoName -Domain $domainName -Server $DomainController `
|
||||||
|
-ErrorAction SilentlyContinue
|
||||||
|
if (-not $staffGpo -and $PSCmdlet.ShouldProcess($StaffGpoName, 'Create local-profile enforcement GPO')) {
|
||||||
|
$staffGpo = New-GPO -Name $StaffGpoName -Domain $domainName -Server $DomainController
|
||||||
|
}
|
||||||
|
if (-not $staffGpo) {
|
||||||
|
throw "The GPO '$StaffGpoName' does not exist and was not created."
|
||||||
|
}
|
||||||
|
$staffLink = @(Get-GPInheritance -Target $laboratoryOuDn -Domain $domainName `
|
||||||
|
-Server $DomainController).GpoLinks |
|
||||||
|
Where-Object DisplayName -eq $StaffGpoName | Select-Object -First 1
|
||||||
|
if (-not $staffLink -and $PSCmdlet.ShouldProcess($laboratoryOuDn, "Link '$StaffGpoName'")) {
|
||||||
|
New-GPLink -Name $StaffGpoName -Target $laboratoryOuDn -Domain $domainName `
|
||||||
|
-Server $DomainController -LinkEnabled Yes | Out-Null
|
||||||
|
}
|
||||||
|
elseif ($staffLink -and -not [bool]$staffLink.Enabled -and
|
||||||
|
$PSCmdlet.ShouldProcess($laboratoryOuDn, "Enable '$StaffGpoName' rollback link")) {
|
||||||
|
Set-GPLink -Name $StaffGpoName -Target $laboratoryOuDn -Domain $domainName `
|
||||||
|
-Server $DomainController -LinkEnabled Yes | Out-Null
|
||||||
|
}
|
||||||
|
|
||||||
|
$profilesRoot = 'HKLM\SOFTWARE\FSLogix\Profiles'
|
||||||
|
Set-SguPolicyValue -GpoName $StaffGpoName -DomainName $domainName -Server $DomainController `
|
||||||
|
-Key $profilesRoot -ValueName Enabled -Type DWord -Value 0
|
||||||
|
Set-SguPolicyValue -GpoName $StaffGpoName -DomainName $domainName -Server $DomainController `
|
||||||
|
-Key 'HKLM\SOFTWARE\FSLogix\ODFC' -ValueName Enabled -Type DWord -Value 0
|
||||||
|
foreach ($serviceName in 'frxsvc','frxccds') {
|
||||||
|
Set-SguPolicyValue -GpoName $StaffGpoName -DomainName $domainName -Server $DomainController `
|
||||||
|
-Key "HKLM\SYSTEM\CurrentControlSet\Services\$serviceName" `
|
||||||
|
-ValueName Start -Type DWord -Value 4
|
||||||
|
}
|
||||||
|
Remove-SguPolicyValue -GpoName $StaffGpoName -DomainName $domainName -Server $DomainController `
|
||||||
|
-Key 'HKLM\SOFTWARE\FSLogix\Apps' -ValueName VHDCompactDisk
|
||||||
|
|
||||||
|
$profileValueNames = @(
|
||||||
|
'CCDLocations','VHDLocations','CcdUnregisterTimeout','ClearCacheOnForcedUnregister',
|
||||||
|
'ClearCacheOnLogoff','HealthyProvidersRequiredForRegister',
|
||||||
|
'HealthyProvidersRequiredForUnregister','PreventLoginWithFailure',
|
||||||
|
'PreventLoginWithTempProfile','DeleteLocalProfileWhenVHDShouldApply',
|
||||||
|
'FlipFlopProfileDirectoryName','IsDynamic','LockedRetryCount','LockedRetryInterval',
|
||||||
|
'ProfileType','ReAttachIntervalSeconds','ReAttachRetryCount','SizeInMBs','VolumeType',
|
||||||
|
'VHDCompactDisk'
|
||||||
|
)
|
||||||
|
$roleGroups = @(
|
||||||
|
Get-ADGroup -Identity "CN=$ProfessorGroupName,$professorOuDn" -Server $DomainController
|
||||||
|
Get-ADGroup -Identity "CN=$AdministrativeGroupName,$administrativeOuDn" -Server $DomainController
|
||||||
|
)
|
||||||
|
foreach ($group in $roleGroups) {
|
||||||
|
$key = "$profilesRoot\ObjectSpecific\$($group.SID.Value)"
|
||||||
|
Set-SguPolicyValue -GpoName $StaffGpoName -DomainName $domainName -Server $DomainController `
|
||||||
|
-Key $key -ValueName Enabled -Type DWord -Value 0
|
||||||
|
foreach ($valueName in $profileValueNames) {
|
||||||
|
Remove-SguPolicyValue -GpoName $StaffGpoName -DomainName $domainName `
|
||||||
|
-Server $DomainController -Key $key -ValueName $valueName
|
||||||
|
}
|
||||||
|
}
|
||||||
|
Set-SguPolicyValue -GpoName $StaffGpoName -DomainName $domainName -Server $DomainController `
|
||||||
|
-Key 'HKLM\SOFTWARE\SGU\UserRoaming' -ValueName StaffProfileStorageMode `
|
||||||
|
-Type String -Value Disabled
|
||||||
|
|
||||||
|
$studentGpo = Get-GPO -Name $StudentGpoName -Domain $domainName -Server $DomainController `
|
||||||
|
-ErrorAction SilentlyContinue
|
||||||
|
if ($studentGpo) {
|
||||||
|
$studentLink = @(Get-GPInheritance -Target $studentOuDn -Domain $domainName `
|
||||||
|
-Server $DomainController).GpoLinks |
|
||||||
|
Where-Object DisplayName -eq $StudentGpoName | Select-Object -First 1
|
||||||
|
if ($studentLink -and -not [bool]$studentLink.Enabled -and
|
||||||
|
$PSCmdlet.ShouldProcess($studentOuDn, "Enable '$StudentGpoName' local-path rollback")) {
|
||||||
|
Set-GPLink -Name $StudentGpoName -Target $studentOuDn -Domain $domainName `
|
||||||
|
-Server $DomainController -LinkEnabled Yes | Out-Null
|
||||||
|
}
|
||||||
|
$shellFoldersKey = 'HKCU\Software\Microsoft\Windows\CurrentVersion\Explorer\User Shell Folders'
|
||||||
|
Set-SguPolicyValue -GpoName $StudentGpoName -DomainName $domainName -Server $DomainController `
|
||||||
|
-Key $shellFoldersKey -ValueName Desktop -Type ExpandString `
|
||||||
|
-Value '%USERPROFILE%\Desktop'
|
||||||
|
Set-SguPolicyValue -GpoName $StudentGpoName -DomainName $domainName -Server $DomainController `
|
||||||
|
-Key $shellFoldersKey -ValueName Personal -Type ExpandString `
|
||||||
|
-Value '%USERPROFILE%\Documents'
|
||||||
|
Remove-SguPolicyValue -GpoName $StudentGpoName -DomainName $domainName `
|
||||||
|
-Server $DomainController -Key 'HKCU\Software\Policies\Microsoft\Windows\NetCache' `
|
||||||
|
-ValueName DisableFRAdminPin
|
||||||
|
}
|
||||||
|
|
||||||
|
$deploymentGpo = Get-GPO -Name $FsLogixDeploymentGpoName -Domain $domainName `
|
||||||
|
-Server $DomainController -ErrorAction SilentlyContinue
|
||||||
|
if ($deploymentGpo) {
|
||||||
|
$deploymentLink = @(Get-GPInheritance -Target $laboratoryOuDn -Domain $domainName `
|
||||||
|
-Server $DomainController).GpoLinks |
|
||||||
|
Where-Object DisplayName -eq $FsLogixDeploymentGpoName | Select-Object -First 1
|
||||||
|
if ($deploymentLink -and [bool]$deploymentLink.Enabled -and
|
||||||
|
$PSCmdlet.ShouldProcess($laboratoryOuDn, "Disable '$FsLogixDeploymentGpoName'")) {
|
||||||
|
Set-GPLink -Name $FsLogixDeploymentGpoName -Target $laboratoryOuDn `
|
||||||
|
-Domain $domainName -Server $DomainController -LinkEnabled No | Out-Null
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
$clearedUsers = [Collections.Generic.List[string]]::new()
|
||||||
|
if (-not $PreserveLegacyUserMappings) {
|
||||||
|
foreach ($roleOu in $studentOuDn,$professorOuDn,$administrativeOuDn) {
|
||||||
|
foreach ($user in Get-ADUser -SearchBase $roleOu -SearchScope Subtree -Filter * `
|
||||||
|
-Server $DomainController -Properties profilePath,homeDirectory,homeDrive) {
|
||||||
|
if ($user.profilePath -or $user.homeDirectory -or $user.homeDrive) {
|
||||||
|
if ($PSCmdlet.ShouldProcess($user.SamAccountName, 'Clear AD profile and home-drive mappings')) {
|
||||||
|
Set-ADUser -Identity $user -Server $DomainController `
|
||||||
|
-Clear profilePath,homeDirectory,homeDrive
|
||||||
|
$clearedUsers.Add($user.SamAccountName)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
$staffGpo = Get-GPO -Name $StaffGpoName -Domain $domainName -Server $DomainController
|
||||||
|
$studentGpo = Get-GPO -Name $StudentGpoName -Domain $domainName -Server $DomainController `
|
||||||
|
-ErrorAction SilentlyContinue
|
||||||
|
$deploymentLink = @(Get-GPInheritance -Target $laboratoryOuDn -Domain $domainName `
|
||||||
|
-Server $DomainController).GpoLinks |
|
||||||
|
Where-Object DisplayName -eq $FsLogixDeploymentGpoName | Select-Object -First 1
|
||||||
|
[pscustomobject]@{
|
||||||
|
Domain = $domainName
|
||||||
|
UserRoamingEnabled = $false
|
||||||
|
StaffGpoVersion = "$($staffGpo.Computer.DSVersion)/$($staffGpo.Computer.SysVolVersion)"
|
||||||
|
StudentGpoVersion = if ($studentGpo) {
|
||||||
|
"$($studentGpo.User.DSVersion)/$($studentGpo.User.SysVolVersion)"
|
||||||
|
} else { $null }
|
||||||
|
FsLogixDeploymentLinkEnabled = [bool]$deploymentLink.Enabled
|
||||||
|
StaffProfilesEnabled = 0
|
||||||
|
StudentDesktop = '%USERPROFILE%\Desktop'
|
||||||
|
StudentDocuments = '%USERPROFILE%\Documents'
|
||||||
|
ClearedAdUsers = @($clearedUsers)
|
||||||
|
RebootManagedWindowsClients = $true
|
||||||
|
}
|
||||||
@@ -18,6 +18,24 @@ if (-not $computer.PartOfDomain) {
|
|||||||
|
|
||||||
$remoteDesktopUsersSid = [Security.Principal.SecurityIdentifier]::new('S-1-5-32-555')
|
$remoteDesktopUsersSid = [Security.Principal.SecurityIdentifier]::new('S-1-5-32-555')
|
||||||
$remoteDesktopUsersGroup = ($remoteDesktopUsersSid.Translate([Security.Principal.NTAccount]).Value -split '\\', 2)[1]
|
$remoteDesktopUsersGroup = ($remoteDesktopUsersSid.Translate([Security.Principal.NTAccount]).Value -split '\\', 2)[1]
|
||||||
|
$remoteDesktopPrincipalSid = ([Security.Principal.NTAccount]::new($RemoteDesktopPrincipal)).Translate(
|
||||||
|
[Security.Principal.SecurityIdentifier])
|
||||||
|
|
||||||
|
function Get-LocalGroupMemberSid {
|
||||||
|
param([Parameter(Mandatory)][string]$Name)
|
||||||
|
|
||||||
|
$group = [ADSI]("WinNT://$env:COMPUTERNAME/$Name,group")
|
||||||
|
foreach ($member in @($group.psbase.Invoke('Members'))) {
|
||||||
|
try {
|
||||||
|
$sidBytes = $member.GetType().InvokeMember('objectSid',
|
||||||
|
[Reflection.BindingFlags]::GetProperty, $null, $member, $null)
|
||||||
|
if ($sidBytes) {
|
||||||
|
([Security.Principal.SecurityIdentifier]::new([byte[]]$sidBytes, 0)).Value
|
||||||
|
}
|
||||||
|
}
|
||||||
|
catch { }
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
if ($PSCmdlet.ShouldProcess($env:COMPUTERNAME, "Enable RDP and grant $RemoteDesktopPrincipal access")) {
|
if ($PSCmdlet.ShouldProcess($env:COMPUTERNAME, "Enable RDP and grant $RemoteDesktopPrincipal access")) {
|
||||||
function Invoke-PowerCfgBestEffort {
|
function Invoke-PowerCfgBestEffort {
|
||||||
@@ -57,9 +75,9 @@ if ($PSCmdlet.ShouldProcess($env:COMPUTERNAME, "Enable RDP and grant $RemoteDesk
|
|||||||
-ErrorAction SilentlyContinue |
|
-ErrorAction SilentlyContinue |
|
||||||
Set-NetFirewallRule -Enabled True -Profile Domain
|
Set-NetFirewallRule -Enabled True -Profile Domain
|
||||||
|
|
||||||
$existingMembers = @(Get-LocalGroupMember -Group $remoteDesktopUsersGroup -ErrorAction SilentlyContinue)
|
$existingMembers = @(Get-LocalGroupMemberSid -Name $remoteDesktopUsersGroup)
|
||||||
if ($existingMembers.Name -notcontains $RemoteDesktopPrincipal) {
|
if ($existingMembers -notcontains $remoteDesktopPrincipalSid.Value) {
|
||||||
Add-LocalGroupMember -Group $remoteDesktopUsersGroup -Member $RemoteDesktopPrincipal
|
Add-LocalGroupMember -Group $remoteDesktopUsersGroup -Member $remoteDesktopPrincipalSid.Value
|
||||||
}
|
}
|
||||||
|
|
||||||
# Use Windows PowerShell so both the inbox and compatible remoting endpoints
|
# Use Windows PowerShell so both the inbox and compatible remoting endpoints
|
||||||
@@ -97,7 +115,7 @@ if ($PSCmdlet.ShouldProcess($env:COMPUTERNAME, "Enable RDP and grant $RemoteDesk
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
$rdpMembers = @(Get-LocalGroupMember -Group $remoteDesktopUsersGroup -ErrorAction SilentlyContinue)
|
$rdpMembers = @(Get-LocalGroupMemberSid -Name $remoteDesktopUsersGroup)
|
||||||
[pscustomobject]@{
|
[pscustomobject]@{
|
||||||
ComputerName = $env:COMPUTERNAME
|
ComputerName = $env:COMPUTERNAME
|
||||||
Domain = $computer.Domain
|
Domain = $computer.Domain
|
||||||
@@ -108,7 +126,7 @@ $rdpMembers = @(Get-LocalGroupMember -Group $remoteDesktopUsersGroup -ErrorActio
|
|||||||
'HKLM:\SYSTEM\CurrentControlSet\Control\Terminal Server\WinStations\RDP-Tcp' `
|
'HKLM:\SYSTEM\CurrentControlSet\Control\Terminal Server\WinStations\RDP-Tcp' `
|
||||||
-Name UserAuthentication) -eq 1
|
-Name UserAuthentication) -eq 1
|
||||||
RemoteDesktopPrincipal = $RemoteDesktopPrincipal
|
RemoteDesktopPrincipal = $RemoteDesktopPrincipal
|
||||||
PrincipalIsAuthorized = $rdpMembers.Name -contains $RemoteDesktopPrincipal
|
PrincipalIsAuthorized = $rdpMembers -contains $remoteDesktopPrincipalSid.Value
|
||||||
TermService = (Get-Service TermService).Status
|
TermService = (Get-Service TermService).Status
|
||||||
WinRM = (Get-Service WinRM).Status
|
WinRM = (Get-Service WinRM).Status
|
||||||
FirewallProfile = 'Domain'
|
FirewallProfile = 'Domain'
|
||||||
|
|||||||
@@ -0,0 +1,550 @@
|
|||||||
|
#Requires -Version 5.1
|
||||||
|
[CmdletBinding(SupportsShouldProcess)]
|
||||||
|
param(
|
||||||
|
[Parameter(Mandatory)][guid]$SubscriptionId,
|
||||||
|
[Parameter(Mandatory)][string]$ResourceGroupName,
|
||||||
|
[Parameter(Mandatory)]
|
||||||
|
[ValidatePattern('^[a-z0-9]{3,24}$')]
|
||||||
|
[string]$StorageAccountName,
|
||||||
|
[ValidatePattern('^[a-z0-9](?:[a-z0-9-]{1,61}[a-z0-9])$')]
|
||||||
|
[string]$FsLogixProfilesShareName = 'profiles',
|
||||||
|
[ValidatePattern('^[a-z0-9](?:[a-z0-9-]{1,61}[a-z0-9])$')]
|
||||||
|
[string]$RedirectedFoldersShareName = 'redirected',
|
||||||
|
[string]$DomainController = $env:COMPUTERNAME,
|
||||||
|
[string]$AzureFilesOuName = 'AzureFilesConfig',
|
||||||
|
[string]$StudentOuName = 'Alumnos',
|
||||||
|
[string]$ProfessorOuName = 'Docentes',
|
||||||
|
[string]$AdministrativeOuName = 'Administrativos',
|
||||||
|
[string]$LaboratoryOuName = 'Laboratorio',
|
||||||
|
[string]$StudentGroupName = 'SGU-Alumnos',
|
||||||
|
[string]$ProfessorGroupName = 'SGU-Docentes',
|
||||||
|
[string]$AdministrativeGroupName = 'SGU-Administrativos',
|
||||||
|
[string]$StudentGpoName = 'SGU - AL redirected folders',
|
||||||
|
[string]$StaffGpoName = 'SGU - AD-DO FSLogix profiles',
|
||||||
|
[ValidateSet('Private', 'Public')]
|
||||||
|
[string]$EndpointAccess = 'Private',
|
||||||
|
[ValidateSet('Auto', 'Direct', 'CloudCache')]
|
||||||
|
[string]$StaffProfileStorageMode = 'Auto',
|
||||||
|
[ValidateRange(1024, 1048576)]
|
||||||
|
[int]$FsLogixProfileSizeMiB = 30000,
|
||||||
|
[string]$AzFilesHybridModulePath,
|
||||||
|
[switch]$UseDeviceAuthentication,
|
||||||
|
[switch]$DeleteExistingStaffLocalProfiles,
|
||||||
|
[switch]$AcknowledgeUserRoamingRisks,
|
||||||
|
[string]$FsLogixDeploymentGpoName = 'SGU - FSLogix client deployment'
|
||||||
|
)
|
||||||
|
|
||||||
|
$ErrorActionPreference = 'Stop'
|
||||||
|
if (-not $AcknowledgeUserRoamingRisks -and -not $WhatIfPreference) {
|
||||||
|
throw 'User roaming is an optional high-risk feature. Pass -AcknowledgeUserRoamingRisks only after reviewing docs/user-roaming.md, testing sign-in and sign-out, and accepting the documented storage and recovery failure modes.'
|
||||||
|
}
|
||||||
|
|
||||||
|
function Assert-Administrator {
|
||||||
|
$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 5.1 session on the SGU domain controller.'
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
function Import-SguAzFilesHybrid {
|
||||||
|
param([string]$ModulePath)
|
||||||
|
|
||||||
|
if ($ModulePath) {
|
||||||
|
if (-not (Test-Path -LiteralPath $ModulePath)) {
|
||||||
|
throw "AzFilesHybridModulePath does not exist: $ModulePath"
|
||||||
|
}
|
||||||
|
$resolvedModule = if (Test-Path -LiteralPath $ModulePath -PathType Container) {
|
||||||
|
Get-ChildItem -LiteralPath $ModulePath -Recurse -File |
|
||||||
|
Where-Object Name -in @('AzFilesHybrid.psd1', 'AzFilesHybrid.psm1') |
|
||||||
|
Sort-Object @{ Expression = { $_.Extension -eq '.psd1' }; Descending = $true }, FullName |
|
||||||
|
Select-Object -First 1
|
||||||
|
}
|
||||||
|
else {
|
||||||
|
Get-Item -LiteralPath $ModulePath
|
||||||
|
}
|
||||||
|
if (-not $resolvedModule) {
|
||||||
|
throw "AzFilesHybrid.psd1 or AzFilesHybrid.psm1 was not found beneath $ModulePath."
|
||||||
|
}
|
||||||
|
Import-Module -Name $resolvedModule.FullName -Force -ErrorAction Stop
|
||||||
|
}
|
||||||
|
else {
|
||||||
|
Import-Module -Name AzFilesHybrid -Force -ErrorAction Stop
|
||||||
|
}
|
||||||
|
|
||||||
|
$joinCommand = Get-Command Join-AzStorageAccount -ErrorAction SilentlyContinue
|
||||||
|
if (-not $joinCommand) {
|
||||||
|
$joinCommand = Get-Command Join-AzStorageAccountForAuth -ErrorAction SilentlyContinue
|
||||||
|
}
|
||||||
|
if (-not $joinCommand) {
|
||||||
|
throw 'AzFilesHybrid did not expose Join-AzStorageAccount. Install the current Microsoft AzFilesHybrid module and retry.'
|
||||||
|
}
|
||||||
|
return $joinCommand
|
||||||
|
}
|
||||||
|
|
||||||
|
function Get-SguStorageSamAccountName {
|
||||||
|
param([Parameter(Mandatory)][string]$StorageName)
|
||||||
|
|
||||||
|
if ($StorageName.Length -le 15) {
|
||||||
|
return $StorageName
|
||||||
|
}
|
||||||
|
$sha256 = [Security.Cryptography.SHA256]::Create()
|
||||||
|
try {
|
||||||
|
$hash = $sha256.ComputeHash([Text.Encoding]::UTF8.GetBytes($StorageName))
|
||||||
|
$suffix = ([BitConverter]::ToString($hash) -replace '-', '').Substring(0, 10).ToLowerInvariant()
|
||||||
|
return "sgufs$suffix"
|
||||||
|
}
|
||||||
|
finally {
|
||||||
|
$sha256.Dispose()
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
function Ensure-SguOrganizationalUnit {
|
||||||
|
param(
|
||||||
|
[Parameter(Mandatory)][string]$Name,
|
||||||
|
[Parameter(Mandatory)][string]$Path,
|
||||||
|
[Parameter(Mandatory)][string]$Server
|
||||||
|
)
|
||||||
|
|
||||||
|
$escapedName = $Name.Replace('\', '\5c').Replace('*', '\2a').Replace('(', '\28').Replace(')', '\29')
|
||||||
|
$ou = Get-ADOrganizationalUnit -LDAPFilter "(ou=$escapedName)" -SearchBase $Path `
|
||||||
|
-SearchScope OneLevel -Server $Server -ErrorAction Stop | Select-Object -First 1
|
||||||
|
if (-not $ou -and $PSCmdlet.ShouldProcess("OU=$Name,$Path", 'Create Azure Files identity OU')) {
|
||||||
|
New-ADOrganizationalUnit -Name $Name -Path $Path -ProtectedFromAccidentalDeletion $true `
|
||||||
|
-Server $Server | Out-Null
|
||||||
|
$ou = Get-ADOrganizationalUnit -Identity "OU=$Name,$Path" -Server $Server
|
||||||
|
}
|
||||||
|
if (-not $ou) {
|
||||||
|
throw "The organizational unit OU=$Name,$Path does not exist."
|
||||||
|
}
|
||||||
|
return $ou
|
||||||
|
}
|
||||||
|
|
||||||
|
function Ensure-SguGpoLink {
|
||||||
|
param(
|
||||||
|
[Parameter(Mandatory)][string]$Name,
|
||||||
|
[Parameter(Mandatory)][string]$TargetOuDn,
|
||||||
|
[Parameter(Mandatory)][string]$DomainName,
|
||||||
|
[Parameter(Mandatory)][string]$Server
|
||||||
|
)
|
||||||
|
|
||||||
|
$gpo = Get-GPO -Name $Name -Domain $DomainName -Server $Server -ErrorAction SilentlyContinue
|
||||||
|
if (-not $gpo -and $PSCmdlet.ShouldProcess($Name, 'Create user-roaming GPO')) {
|
||||||
|
$gpo = New-GPO -Name $Name -Domain $DomainName -Server $Server
|
||||||
|
}
|
||||||
|
if (-not $gpo) {
|
||||||
|
throw "The GPO '$Name' does not exist and was not created."
|
||||||
|
}
|
||||||
|
|
||||||
|
$link = @(Get-GPInheritance -Target $TargetOuDn -Domain $DomainName -Server $Server).GpoLinks |
|
||||||
|
Where-Object DisplayName -eq $Name | Select-Object -First 1
|
||||||
|
$linkEnabled = $link -and ($link.Enabled -eq $true -or [string]$link.Enabled -eq 'Yes')
|
||||||
|
if (-not $link -and $PSCmdlet.ShouldProcess($TargetOuDn, "Link and enable '$Name'")) {
|
||||||
|
New-GPLink -Name $Name -Target $TargetOuDn -Domain $DomainName -Server $Server `
|
||||||
|
-LinkEnabled Yes | Out-Null
|
||||||
|
}
|
||||||
|
elseif ($link -and -not $linkEnabled -and
|
||||||
|
$PSCmdlet.ShouldProcess($TargetOuDn, "Enable the '$Name' link")) {
|
||||||
|
Set-GPLink -Name $Name -Target $TargetOuDn -Domain $DomainName -Server $Server `
|
||||||
|
-LinkEnabled Yes | Out-Null
|
||||||
|
}
|
||||||
|
return $gpo
|
||||||
|
}
|
||||||
|
|
||||||
|
function Set-SguGpoRegistryValue {
|
||||||
|
param(
|
||||||
|
[Parameter(Mandatory)][string]$GpoName,
|
||||||
|
[Parameter(Mandatory)][string]$DomainName,
|
||||||
|
[Parameter(Mandatory)][string]$Server,
|
||||||
|
[Parameter(Mandatory)][string]$Key,
|
||||||
|
[Parameter(Mandatory)][string]$ValueName,
|
||||||
|
[Parameter(Mandatory)][ValidateSet('DWord', 'String', 'ExpandString')][string]$Type,
|
||||||
|
[Parameter(Mandatory)]$Value
|
||||||
|
)
|
||||||
|
|
||||||
|
if ($PSCmdlet.ShouldProcess("$GpoName :: $Key\\$ValueName", "Set $Type policy value")) {
|
||||||
|
Remove-GPRegistryValue -Name $GpoName -Domain $DomainName -Server $Server `
|
||||||
|
-Key $Key -ValueName "**del.$ValueName" -ErrorAction SilentlyContinue | Out-Null
|
||||||
|
Set-GPRegistryValue -Name $GpoName -Domain $DomainName -Server $Server `
|
||||||
|
-Key $Key -ValueName $ValueName -Type $Type -Value $Value | Out-Null
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
function Remove-SguGpoRegistryValue {
|
||||||
|
param(
|
||||||
|
[Parameter(Mandatory)][string]$GpoName,
|
||||||
|
[Parameter(Mandatory)][string]$DomainName,
|
||||||
|
[Parameter(Mandatory)][string]$Server,
|
||||||
|
[Parameter(Mandatory)][string]$Key,
|
||||||
|
[Parameter(Mandatory)][string]$ValueName
|
||||||
|
)
|
||||||
|
|
||||||
|
if ($PSCmdlet.ShouldProcess("$GpoName :: $Key\$ValueName", 'Remove obsolete policy value')) {
|
||||||
|
Remove-GPRegistryValue -Name $GpoName -Domain $DomainName -Server $Server `
|
||||||
|
-Key $Key -ValueName $ValueName -ErrorAction SilentlyContinue
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
function Set-SguGpoRegistryValueDeletion {
|
||||||
|
param(
|
||||||
|
[Parameter(Mandatory)][string]$GpoName,
|
||||||
|
[Parameter(Mandatory)][string]$DomainName,
|
||||||
|
[Parameter(Mandatory)][string]$Server,
|
||||||
|
[Parameter(Mandatory)][string]$Key,
|
||||||
|
[Parameter(Mandatory)][string]$ValueName
|
||||||
|
)
|
||||||
|
|
||||||
|
Remove-SguGpoRegistryValue -GpoName $GpoName -DomainName $DomainName -Server $Server `
|
||||||
|
-Key $Key -ValueName $ValueName
|
||||||
|
Set-SguGpoRegistryValue -GpoName $GpoName -DomainName $DomainName -Server $Server `
|
||||||
|
-Key $Key -ValueName "**del.$ValueName" -Type String -Value ''
|
||||||
|
}
|
||||||
|
|
||||||
|
function Get-SguUnusedDriveName {
|
||||||
|
$used = @(Get-PSDrive -PSProvider FileSystem | Select-Object -ExpandProperty Name)
|
||||||
|
foreach ($name in @('Z', 'Y', 'X', 'W', 'V')) {
|
||||||
|
if ($used -notcontains $name) {
|
||||||
|
return $name
|
||||||
|
}
|
||||||
|
}
|
||||||
|
throw 'No temporary drive letter is available for configuring Azure Files ACLs.'
|
||||||
|
}
|
||||||
|
|
||||||
|
function Set-SguAzureFileRootAcl {
|
||||||
|
param(
|
||||||
|
[Parameter(Mandatory)][string]$UncPath,
|
||||||
|
[Parameter(Mandatory)][PSCredential]$Credential,
|
||||||
|
[Parameter(Mandatory)][Security.Principal.SecurityIdentifier]$DomainAdminsSid,
|
||||||
|
[Parameter(Mandatory)][Security.Principal.SecurityIdentifier[]]$ContributorSids,
|
||||||
|
[Security.AccessControl.FileSystemRights]$ContributorRights =
|
||||||
|
[Security.AccessControl.FileSystemRights]::Modify
|
||||||
|
)
|
||||||
|
|
||||||
|
$driveName = Get-SguUnusedDriveName
|
||||||
|
try {
|
||||||
|
New-PSDrive -Name $driveName -PSProvider FileSystem -Root $UncPath `
|
||||||
|
-Credential $Credential -Scope Script -ErrorAction Stop | Out-Null
|
||||||
|
$rootPath = "${driveName}:\"
|
||||||
|
$acl = [Security.AccessControl.DirectorySecurity]::new()
|
||||||
|
$acl.SetAccessRuleProtection($true, $false)
|
||||||
|
$acl.SetOwner($DomainAdminsSid)
|
||||||
|
$allow = [Security.AccessControl.AccessControlType]::Allow
|
||||||
|
$containerAndObject = [Security.AccessControl.InheritanceFlags]'ContainerInherit,ObjectInherit'
|
||||||
|
$noneInheritance = [Security.AccessControl.InheritanceFlags]::None
|
||||||
|
$nonePropagation = [Security.AccessControl.PropagationFlags]::None
|
||||||
|
$inheritOnly = [Security.AccessControl.PropagationFlags]::InheritOnly
|
||||||
|
$systemSid = [Security.Principal.SecurityIdentifier]::new('S-1-5-18')
|
||||||
|
$creatorOwnerSid = [Security.Principal.SecurityIdentifier]::new('S-1-3-0')
|
||||||
|
foreach ($administratorSid in @($systemSid, $DomainAdminsSid)) {
|
||||||
|
$acl.AddAccessRule([Security.AccessControl.FileSystemAccessRule]::new(
|
||||||
|
$administratorSid,
|
||||||
|
[Security.AccessControl.FileSystemRights]::FullControl,
|
||||||
|
$containerAndObject,
|
||||||
|
$nonePropagation,
|
||||||
|
$allow))
|
||||||
|
}
|
||||||
|
$acl.AddAccessRule([Security.AccessControl.FileSystemAccessRule]::new(
|
||||||
|
$creatorOwnerSid,
|
||||||
|
[Security.AccessControl.FileSystemRights]::Modify,
|
||||||
|
$containerAndObject,
|
||||||
|
$inheritOnly,
|
||||||
|
$allow))
|
||||||
|
foreach ($contributorSid in $ContributorSids) {
|
||||||
|
$acl.AddAccessRule([Security.AccessControl.FileSystemAccessRule]::new(
|
||||||
|
$contributorSid,
|
||||||
|
$ContributorRights,
|
||||||
|
$noneInheritance,
|
||||||
|
$nonePropagation,
|
||||||
|
$allow))
|
||||||
|
}
|
||||||
|
Set-Acl -LiteralPath $rootPath -AclObject $acl -ErrorAction Stop
|
||||||
|
}
|
||||||
|
finally {
|
||||||
|
Remove-PSDrive -Name $driveName -Scope Script -Force -ErrorAction SilentlyContinue
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
Assert-Administrator
|
||||||
|
if ($FsLogixProfilesShareName.Contains('--') -or $RedirectedFoldersShareName.Contains('--')) {
|
||||||
|
throw 'Azure Files share names cannot contain consecutive hyphens.'
|
||||||
|
}
|
||||||
|
if ($FsLogixProfilesShareName -eq $RedirectedFoldersShareName) {
|
||||||
|
throw 'The profile-container and redirected-folder shares must have different names.'
|
||||||
|
}
|
||||||
|
|
||||||
|
Import-Module ActiveDirectory -ErrorAction Stop
|
||||||
|
Import-Module GroupPolicy -ErrorAction Stop
|
||||||
|
foreach ($azureModule in @('Az.Accounts', 'Az.Storage')) {
|
||||||
|
try {
|
||||||
|
Import-Module $azureModule -ErrorAction Stop
|
||||||
|
}
|
||||||
|
catch {
|
||||||
|
throw "The current $azureModule module is required on the domain controller. Install Azure PowerShell and retry. $($_.Exception.Message)"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
$joinStorageCommand = Import-SguAzFilesHybrid -ModulePath $AzFilesHybridModulePath
|
||||||
|
|
||||||
|
$domain = Get-ADDomain -Server $DomainController
|
||||||
|
$baseDn = $domain.DistinguishedName
|
||||||
|
$domainName = $domain.DNSRoot
|
||||||
|
$usersOuDn = "OU=Usuarios-SGU,$baseDn"
|
||||||
|
$studentOuDn = "OU=$StudentOuName,$usersOuDn"
|
||||||
|
$professorOuDn = "OU=$ProfessorOuName,$usersOuDn"
|
||||||
|
$administrativeOuDn = "OU=$AdministrativeOuName,$usersOuDn"
|
||||||
|
$laboratoryOuDn = "OU=$LaboratoryOuName,$baseDn"
|
||||||
|
foreach ($requiredOu in @($studentOuDn, $professorOuDn, $administrativeOuDn, $laboratoryOuDn)) {
|
||||||
|
Get-ADOrganizationalUnit -Identity $requiredOu -Server $DomainController -ErrorAction Stop | Out-Null
|
||||||
|
}
|
||||||
|
|
||||||
|
$studentGroup = Get-ADGroup -Identity "CN=$StudentGroupName,$studentOuDn" -Server $DomainController
|
||||||
|
$professorGroup = Get-ADGroup -Identity "CN=$ProfessorGroupName,$professorOuDn" -Server $DomainController
|
||||||
|
$administrativeGroup = Get-ADGroup -Identity "CN=$AdministrativeGroupName,$administrativeOuDn" `
|
||||||
|
-Server $DomainController
|
||||||
|
$domainAdminsSid = [Security.Principal.SecurityIdentifier]::new("$($domain.DomainSID.Value)-512")
|
||||||
|
$azureFilesOu = Ensure-SguOrganizationalUnit -Name $AzureFilesOuName -Path $baseDn -Server $DomainController
|
||||||
|
|
||||||
|
$azureContext = Get-AzContext -ErrorAction SilentlyContinue
|
||||||
|
if (-not $azureContext -or $azureContext.Subscription.Id -ne $SubscriptionId.Guid) {
|
||||||
|
$connectParameters = @{}
|
||||||
|
if ($UseDeviceAuthentication) {
|
||||||
|
$connectParameters.UseDeviceAuthentication = $true
|
||||||
|
}
|
||||||
|
Connect-AzAccount @connectParameters | Out-Null
|
||||||
|
}
|
||||||
|
Set-AzContext -SubscriptionId $SubscriptionId.Guid | Out-Null
|
||||||
|
$storageAccount = Get-AzStorageAccount -ResourceGroupName $ResourceGroupName `
|
||||||
|
-Name $StorageAccountName -ErrorAction Stop
|
||||||
|
$fileEndpointHost = ([uri]$storageAccount.PrimaryEndpoints.File).Host
|
||||||
|
if (-not $fileEndpointHost) {
|
||||||
|
throw "Azure did not return a file endpoint for $StorageAccountName."
|
||||||
|
}
|
||||||
|
|
||||||
|
$directoryService = [string]$storageAccount.AzureFilesIdentityBasedAuth.DirectoryServiceOptions
|
||||||
|
if ($directoryService -and $directoryService -ne 'None' -and $directoryService -ne 'AD') {
|
||||||
|
throw "Storage account $StorageAccountName already uses the incompatible Azure Files identity source '$directoryService'."
|
||||||
|
}
|
||||||
|
if ($directoryService -ne 'AD') {
|
||||||
|
if ($PSCmdlet.ShouldProcess($StorageAccountName, "Join Azure Files to $domainName with AES-256 Kerberos")) {
|
||||||
|
$requestedSamAccountName = Get-SguStorageSamAccountName -StorageName $StorageAccountName
|
||||||
|
$joinParameters = @{
|
||||||
|
ResourceGroupName = $ResourceGroupName
|
||||||
|
StorageAccountName = $StorageAccountName
|
||||||
|
SamAccountName = $requestedSamAccountName
|
||||||
|
DomainAccountType = 'ComputerAccount'
|
||||||
|
OrganizationalUnitDistinguishedName = $azureFilesOu.DistinguishedName
|
||||||
|
}
|
||||||
|
& $joinStorageCommand @joinParameters
|
||||||
|
$storageAccount = Get-AzStorageAccount -ResourceGroupName $ResourceGroupName `
|
||||||
|
-Name $StorageAccountName -ErrorAction Stop
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
$directoryService = [string]$storageAccount.AzureFilesIdentityBasedAuth.DirectoryServiceOptions
|
||||||
|
if ($directoryService -ne 'AD') {
|
||||||
|
throw "Azure Files identity authentication is '$directoryService', not AD. The domain join did not complete."
|
||||||
|
}
|
||||||
|
$activeDirectoryProperties = $storageAccount.AzureFilesIdentityBasedAuth.ActiveDirectoryProperties
|
||||||
|
if ([string]$activeDirectoryProperties.DomainName -ne $domainName) {
|
||||||
|
throw "Storage account $StorageAccountName is joined to $($activeDirectoryProperties.DomainName), not $domainName."
|
||||||
|
}
|
||||||
|
$storageSamAccountName = [string]$activeDirectoryProperties.SamAccountName
|
||||||
|
if (-not $storageSamAccountName) {
|
||||||
|
$storageSamAccountName = $StorageAccountName
|
||||||
|
}
|
||||||
|
$storageComputer = Get-ADComputer -Identity "${storageSamAccountName}$" `
|
||||||
|
-Server $DomainController -ErrorAction Stop
|
||||||
|
if ($PSCmdlet.ShouldProcess($storageComputer.DistinguishedName, 'Require AES-256 Kerberos and prevent an unattended storage identity password expiry')) {
|
||||||
|
Set-ADComputer -Identity $storageComputer -Server $DomainController `
|
||||||
|
-KerberosEncryptionType AES256 -PasswordNeverExpires $true
|
||||||
|
}
|
||||||
|
if ($PSCmdlet.ShouldProcess($StorageAccountName, 'Grant authenticated AD identities the Azure Files SMB contributor default share permission')) {
|
||||||
|
$storageAccount = Set-AzStorageAccount -ResourceGroupName $ResourceGroupName `
|
||||||
|
-Name $StorageAccountName `
|
||||||
|
-DefaultSharePermission StorageFileDataSmbShareContributor
|
||||||
|
}
|
||||||
|
|
||||||
|
$endpointAddresses = @(Resolve-DnsName -Name $fileEndpointHost -Type A -ErrorAction Stop |
|
||||||
|
Where-Object IPAddress | Select-Object -ExpandProperty IPAddress)
|
||||||
|
if ($endpointAddresses.Count -eq 0) {
|
||||||
|
throw "$fileEndpointHost did not resolve to an IPv4 address."
|
||||||
|
}
|
||||||
|
$privateAddresses = @($endpointAddresses | Where-Object {
|
||||||
|
$_ -match '^(10\.|192\.168\.|172\.(1[6-9]|2\d|3[01])\.)'
|
||||||
|
})
|
||||||
|
if ($EndpointAccess -eq 'Private' -and $privateAddresses.Count -eq 0) {
|
||||||
|
throw "$fileEndpointHost did not resolve to a private endpoint. Verify the privatelink.file.core.windows.net VNet link and the DC Azure DNS forwarder."
|
||||||
|
}
|
||||||
|
if (-not (Test-NetConnection -ComputerName $fileEndpointHost -Port 445 -InformationLevel Quiet)) {
|
||||||
|
throw "The domain controller cannot reach $fileEndpointHost on TCP 445 using the selected $EndpointAccess endpoint."
|
||||||
|
}
|
||||||
|
|
||||||
|
$storageKey = @(Get-AzStorageAccountKey -ResourceGroupName $ResourceGroupName `
|
||||||
|
-Name $StorageAccountName -ErrorAction Stop | Where-Object KeyName -eq 'key1' |
|
||||||
|
Select-Object -First 1).Value
|
||||||
|
if (-not $storageKey) {
|
||||||
|
throw "Azure did not return key1 for $StorageAccountName; it is required only to set the initial root ACLs."
|
||||||
|
}
|
||||||
|
$storageCredential = [PSCredential]::new(
|
||||||
|
"Azure\$StorageAccountName",
|
||||||
|
(ConvertTo-SecureString -String $storageKey -AsPlainText -Force))
|
||||||
|
$profilesSharePath = "\\$fileEndpointHost\$FsLogixProfilesShareName"
|
||||||
|
$redirectedFoldersSharePath = "\\$fileEndpointHost\$RedirectedFoldersShareName"
|
||||||
|
$resolvedStaffProfileStorageMode = if ($StaffProfileStorageMode -eq 'Auto') {
|
||||||
|
if ($EndpointAccess -eq 'Public') { 'CloudCache' } else { 'Direct' }
|
||||||
|
}
|
||||||
|
else {
|
||||||
|
$StaffProfileStorageMode
|
||||||
|
}
|
||||||
|
$perUserRootRights = [Security.AccessControl.FileSystemRights]::CreateDirectories -bor
|
||||||
|
[Security.AccessControl.FileSystemRights]::ListDirectory -bor
|
||||||
|
[Security.AccessControl.FileSystemRights]::ReadAttributes -bor
|
||||||
|
[Security.AccessControl.FileSystemRights]::ReadExtendedAttributes -bor
|
||||||
|
[Security.AccessControl.FileSystemRights]::ReadPermissions -bor
|
||||||
|
[Security.AccessControl.FileSystemRights]::Traverse -bor
|
||||||
|
[Security.AccessControl.FileSystemRights]::Synchronize
|
||||||
|
try {
|
||||||
|
if ($PSCmdlet.ShouldProcess($profilesSharePath, 'Apply isolated FSLogix root ACLs')) {
|
||||||
|
Set-SguAzureFileRootAcl -UncPath $profilesSharePath -Credential $storageCredential `
|
||||||
|
-DomainAdminsSid $domainAdminsSid `
|
||||||
|
-ContributorSids @($professorGroup.SID, $administrativeGroup.SID) `
|
||||||
|
-ContributorRights $perUserRootRights
|
||||||
|
}
|
||||||
|
if ($PSCmdlet.ShouldProcess($redirectedFoldersSharePath, 'Apply isolated student-folder root ACLs')) {
|
||||||
|
Set-SguAzureFileRootAcl -UncPath $redirectedFoldersSharePath -Credential $storageCredential `
|
||||||
|
-DomainAdminsSid $domainAdminsSid -ContributorSids @($studentGroup.SID) `
|
||||||
|
-ContributorRights $perUserRootRights
|
||||||
|
}
|
||||||
|
}
|
||||||
|
finally {
|
||||||
|
$storageKey = $null
|
||||||
|
$storageCredential = $null
|
||||||
|
}
|
||||||
|
|
||||||
|
$studentGpo = Ensure-SguGpoLink -Name $StudentGpoName -TargetOuDn $studentOuDn `
|
||||||
|
-DomainName $domainName -Server $DomainController
|
||||||
|
$userShellFoldersKey = 'HKCU\Software\Microsoft\Windows\CurrentVersion\Explorer\User Shell Folders'
|
||||||
|
Set-SguGpoRegistryValue -GpoName $studentGpo.DisplayName -DomainName $domainName `
|
||||||
|
-Server $DomainController -Key $userShellFoldersKey -ValueName 'Desktop' `
|
||||||
|
-Type ExpandString -Value "$redirectedFoldersSharePath\%USERNAME%\Desktop"
|
||||||
|
Set-SguGpoRegistryValue -GpoName $studentGpo.DisplayName -DomainName $domainName `
|
||||||
|
-Server $DomainController -Key $userShellFoldersKey -ValueName 'Personal' `
|
||||||
|
-Type ExpandString -Value "$redirectedFoldersSharePath\%USERNAME%\Documents"
|
||||||
|
Set-SguGpoRegistryValue -GpoName $studentGpo.DisplayName -DomainName $domainName `
|
||||||
|
-Server $DomainController -Key 'HKCU\Software\Policies\Microsoft\Windows\NetCache' `
|
||||||
|
-ValueName 'DisableFRAdminPin' -Type DWord -Value 1
|
||||||
|
|
||||||
|
$staffGpo = Ensure-SguGpoLink -Name $StaffGpoName -TargetOuDn $laboratoryOuDn `
|
||||||
|
-DomainName $domainName -Server $DomainController
|
||||||
|
$fsLogixRoot = 'HKLM\SOFTWARE\FSLogix\Profiles'
|
||||||
|
Set-SguGpoRegistryValue -GpoName $staffGpo.DisplayName -DomainName $domainName `
|
||||||
|
-Server $DomainController -Key $fsLogixRoot -ValueName 'Enabled' -Type DWord -Value 0
|
||||||
|
Set-SguGpoRegistryValue -GpoName $staffGpo.DisplayName -DomainName $domainName `
|
||||||
|
-Server $DomainController -Key 'HKLM\SYSTEM\CurrentControlSet\Services\frxsvc' `
|
||||||
|
-ValueName 'Start' -Type DWord -Value 2
|
||||||
|
Set-SguGpoRegistryValue -GpoName $staffGpo.DisplayName -DomainName $domainName `
|
||||||
|
-Server $DomainController -Key 'HKLM\SYSTEM\CurrentControlSet\Services\frxccds' `
|
||||||
|
-ValueName 'Start' -Type DWord -Value 2
|
||||||
|
$deploymentGpo = Get-GPO -Name $FsLogixDeploymentGpoName -Domain $domainName `
|
||||||
|
-Server $DomainController -ErrorAction SilentlyContinue
|
||||||
|
if ($deploymentGpo) {
|
||||||
|
$deploymentLink = @(Get-GPInheritance -Target $laboratoryOuDn -Domain $domainName `
|
||||||
|
-Server $DomainController).GpoLinks |
|
||||||
|
Where-Object DisplayName -eq $FsLogixDeploymentGpoName | Select-Object -First 1
|
||||||
|
if ($deploymentLink -and -not [bool]$deploymentLink.Enabled -and
|
||||||
|
$PSCmdlet.ShouldProcess($laboratoryOuDn, "Enable '$FsLogixDeploymentGpoName'")) {
|
||||||
|
Set-GPLink -Name $FsLogixDeploymentGpoName -Target $laboratoryOuDn `
|
||||||
|
-Domain $domainName -Server $DomainController -LinkEnabled Yes | Out-Null
|
||||||
|
}
|
||||||
|
}
|
||||||
|
$fsLogixValues = [ordered]@{
|
||||||
|
Enabled = @{ Type = 'DWord'; Value = 1 }
|
||||||
|
DeleteLocalProfileWhenVHDShouldApply = @{
|
||||||
|
Type = 'DWord'
|
||||||
|
Value = if ($DeleteExistingStaffLocalProfiles) { 1 } else { 0 }
|
||||||
|
}
|
||||||
|
FlipFlopProfileDirectoryName = @{ Type = 'DWord'; Value = 1 }
|
||||||
|
IsDynamic = @{ Type = 'DWord'; Value = 1 }
|
||||||
|
LockedRetryCount = @{ Type = 'DWord'; Value = 3 }
|
||||||
|
LockedRetryInterval = @{ Type = 'DWord'; Value = 15 }
|
||||||
|
ProfileType = @{ Type = 'DWord'; Value = 0 }
|
||||||
|
ReAttachIntervalSeconds = @{ Type = 'DWord'; Value = 15 }
|
||||||
|
ReAttachRetryCount = @{ Type = 'DWord'; Value = 3 }
|
||||||
|
SizeInMBs = @{ Type = 'DWord'; Value = $FsLogixProfileSizeMiB }
|
||||||
|
VolumeType = @{ Type = 'String'; Value = 'VHDX' }
|
||||||
|
}
|
||||||
|
$cloudCacheOnlyValues = @(
|
||||||
|
'CCDLocations',
|
||||||
|
'CcdUnregisterTimeout',
|
||||||
|
'ClearCacheOnForcedUnregister',
|
||||||
|
'ClearCacheOnLogoff',
|
||||||
|
'HealthyProvidersRequiredForRegister',
|
||||||
|
'HealthyProvidersRequiredForUnregister',
|
||||||
|
'PreventLoginWithFailure',
|
||||||
|
'PreventLoginWithTempProfile'
|
||||||
|
)
|
||||||
|
if ($resolvedStaffProfileStorageMode -eq 'CloudCache') {
|
||||||
|
$fsLogixValues.CCDLocations = @{
|
||||||
|
Type = 'String'
|
||||||
|
Value = "type=smb,name=`"SGU Azure Files`",connectionString=$profilesSharePath"
|
||||||
|
}
|
||||||
|
$fsLogixValues.CcdUnregisterTimeout = @{ Type = 'DWord'; Value = 60 }
|
||||||
|
$fsLogixValues.ClearCacheOnForcedUnregister = @{ Type = 'DWord'; Value = 0 }
|
||||||
|
$fsLogixValues.ClearCacheOnLogoff = @{ Type = 'DWord'; Value = 0 }
|
||||||
|
$fsLogixValues.HealthyProvidersRequiredForRegister = @{ Type = 'DWord'; Value = 1 }
|
||||||
|
$fsLogixValues.HealthyProvidersRequiredForUnregister = @{ Type = 'DWord'; Value = 1 }
|
||||||
|
$fsLogixValues.PreventLoginWithFailure = @{ Type = 'DWord'; Value = 1 }
|
||||||
|
$fsLogixValues.PreventLoginWithTempProfile = @{ Type = 'DWord'; Value = 1 }
|
||||||
|
}
|
||||||
|
else {
|
||||||
|
$fsLogixValues.VHDLocations = @{ Type = 'String'; Value = $profilesSharePath }
|
||||||
|
}
|
||||||
|
Set-SguGpoRegistryValue -GpoName $staffGpo.DisplayName -DomainName $domainName `
|
||||||
|
-Server $DomainController -Key 'HKLM\SOFTWARE\FSLogix\Apps' `
|
||||||
|
-ValueName 'VHDCompactDisk' -Type DWord -Value 0
|
||||||
|
foreach ($staffGroup in @($professorGroup, $administrativeGroup)) {
|
||||||
|
$objectSpecificKey = "$fsLogixRoot\ObjectSpecific\$($staffGroup.SID.Value)"
|
||||||
|
Set-SguGpoRegistryValueDeletion -GpoName $staffGpo.DisplayName -DomainName $domainName `
|
||||||
|
-Server $DomainController -Key $objectSpecificKey -ValueName 'VHDCompactDisk'
|
||||||
|
if ($resolvedStaffProfileStorageMode -eq 'CloudCache') {
|
||||||
|
Set-SguGpoRegistryValueDeletion -GpoName $staffGpo.DisplayName -DomainName $domainName `
|
||||||
|
-Server $DomainController -Key $objectSpecificKey -ValueName 'VHDLocations'
|
||||||
|
}
|
||||||
|
else {
|
||||||
|
foreach ($obsoleteValue in $cloudCacheOnlyValues) {
|
||||||
|
Set-SguGpoRegistryValueDeletion -GpoName $staffGpo.DisplayName -DomainName $domainName `
|
||||||
|
-Server $DomainController -Key $objectSpecificKey -ValueName $obsoleteValue
|
||||||
|
}
|
||||||
|
}
|
||||||
|
foreach ($setting in $fsLogixValues.GetEnumerator()) {
|
||||||
|
Remove-SguGpoRegistryValue -GpoName $staffGpo.DisplayName -DomainName $domainName `
|
||||||
|
-Server $DomainController -Key $objectSpecificKey -ValueName "**del.$($setting.Key)"
|
||||||
|
Set-SguGpoRegistryValue -GpoName $staffGpo.DisplayName -DomainName $domainName `
|
||||||
|
-Server $DomainController -Key $objectSpecificKey -ValueName $setting.Key `
|
||||||
|
-Type $setting.Value.Type -Value $setting.Value.Value
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
[pscustomobject]@{
|
||||||
|
StorageAccountName = $StorageAccountName
|
||||||
|
FileEndpoint = $fileEndpointHost
|
||||||
|
EndpointAccess = $EndpointAccess
|
||||||
|
StaffProfileStorageMode = $resolvedStaffProfileStorageMode
|
||||||
|
EndpointAddresses = $endpointAddresses
|
||||||
|
PrivateEndpointAddresses = $privateAddresses
|
||||||
|
DirectoryService = $directoryService
|
||||||
|
KerberosEncryption = 'AES256'
|
||||||
|
StorageIdentity = $storageComputer.DistinguishedName
|
||||||
|
StorageIdentityPasswordNeverExpires = $true
|
||||||
|
ProfilesSharePath = $profilesSharePath
|
||||||
|
RedirectedFoldersSharePath = $redirectedFoldersSharePath
|
||||||
|
StudentPolicy = $studentGpo.DisplayName
|
||||||
|
StaffPolicy = $staffGpo.DisplayName
|
||||||
|
StudentBehavior = 'Local non-authoritative profile; Documents and Desktop redirected without Offline Files pinning.'
|
||||||
|
StaffBehavior = if ($resolvedStaffProfileStorageMode -eq 'CloudCache') {
|
||||||
|
'FSLogix Cloud Cache profile container for SGU-Docentes and SGU-Administrativos only; local I/O is synchronized to Azure Files.'
|
||||||
|
}
|
||||||
|
else {
|
||||||
|
'Direct FSLogix VHDX profile container for SGU-Docentes and SGU-Administrativos only.'
|
||||||
|
}
|
||||||
|
ExistingStaffLocalProfilesDeleted = [bool]$DeleteExistingStaffLocalProfiles
|
||||||
|
}
|
||||||
@@ -0,0 +1,78 @@
|
|||||||
|
[CmdletBinding(SupportsShouldProcess)]
|
||||||
|
param()
|
||||||
|
|
||||||
|
$ErrorActionPreference = 'Stop'
|
||||||
|
|
||||||
|
function Get-LocalGroupMemberSid {
|
||||||
|
param([Parameter(Mandatory)][string]$Name)
|
||||||
|
|
||||||
|
$group = [ADSI]("WinNT://$env:COMPUTERNAME/$Name,group")
|
||||||
|
foreach ($member in @($group.psbase.Invoke('Members'))) {
|
||||||
|
try {
|
||||||
|
$sidBytes = $member.GetType().InvokeMember('objectSid',
|
||||||
|
[Reflection.BindingFlags]::GetProperty, $null, $member, $null)
|
||||||
|
if ($sidBytes) {
|
||||||
|
([Security.Principal.SecurityIdentifier]::new([byte[]]$sidBytes, 0)).Value
|
||||||
|
}
|
||||||
|
}
|
||||||
|
catch { }
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
$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.'
|
||||||
|
}
|
||||||
|
|
||||||
|
# Use invariant audit subcategory GUIDs so this works on English and Spanish
|
||||||
|
# installations. Logon, logoff, and other logon/logoff events provide the
|
||||||
|
# session identifiers required to correlate usage centrally.
|
||||||
|
$auditSubcategories = @(
|
||||||
|
'{0CCE9215-69AE-11D9-BED3-505054503030}', # Logon
|
||||||
|
'{0CCE9216-69AE-11D9-BED3-505054503030}', # Logoff
|
||||||
|
'{0CCE921C-69AE-11D9-BED3-505054503030}' # Other Logon/Logoff Events
|
||||||
|
)
|
||||||
|
|
||||||
|
if ($PSCmdlet.ShouldProcess($env:COMPUTERNAME, 'Enable SGU session auditing and event forwarding prerequisites')) {
|
||||||
|
foreach ($subcategory in $auditSubcategories) {
|
||||||
|
& auditpol.exe /set "/subcategory:$subcategory" /success:enable /failure:enable | Out-Null
|
||||||
|
if ($LASTEXITCODE -ne 0) {
|
||||||
|
throw "auditpol failed for subcategory $subcategory with exit code $LASTEXITCODE."
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
# Security events are read by the Windows Event Forwarding plug-in under
|
||||||
|
# NETWORK SERVICE. Resolve both principals by SID for localized Windows.
|
||||||
|
$eventLogReadersSid = [Security.Principal.SecurityIdentifier]::new('S-1-5-32-573')
|
||||||
|
$networkServiceSid = [Security.Principal.SecurityIdentifier]::new('S-1-5-20')
|
||||||
|
$eventLogReadersGroup = ($eventLogReadersSid.Translate(
|
||||||
|
[Security.Principal.NTAccount]).Value -split '\\', 2)[1]
|
||||||
|
$members = @(Get-LocalGroupMemberSid -Name $eventLogReadersGroup)
|
||||||
|
$eventLogReaderMembershipChanged = $false
|
||||||
|
if ($members -notcontains $networkServiceSid.Value) {
|
||||||
|
Add-LocalGroupMember -SID $eventLogReadersSid -Member $networkServiceSid.Value
|
||||||
|
$eventLogReaderMembershipChanged = $true
|
||||||
|
}
|
||||||
|
|
||||||
|
Set-Service WinRM -StartupType Automatic
|
||||||
|
if ((Get-Service WinRM).Status -ne 'Running') {
|
||||||
|
Start-Service WinRM
|
||||||
|
}
|
||||||
|
elseif ($eventLogReaderMembershipChanged) {
|
||||||
|
Restart-Service WinRM -Force
|
||||||
|
}
|
||||||
|
|
||||||
|
& wevtutil.exe set-log Security /maxsize:268435456 /retention:false /autobackup:false
|
||||||
|
if ($LASTEXITCODE -ne 0) {
|
||||||
|
throw "wevtutil failed to configure the local Security log with exit code $LASTEXITCODE."
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
[pscustomobject]@{
|
||||||
|
ComputerName = $env:COMPUTERNAME
|
||||||
|
WinRM = (Get-Service WinRM).Status.ToString()
|
||||||
|
SecurityLogMaximumBytes = (Get-WinEvent -ListLog Security).MaximumSizeInBytes
|
||||||
|
AuditSubcategories = $auditSubcategories
|
||||||
|
EventForwardingPolicy = Test-Path 'HKLM:\SOFTWARE\Policies\Microsoft\Windows\EventLog\EventForwarding\SubscriptionManager'
|
||||||
|
}
|
||||||
@@ -0,0 +1,105 @@
|
|||||||
|
[CmdletBinding()]
|
||||||
|
param()
|
||||||
|
|
||||||
|
$ErrorActionPreference = 'Stop'
|
||||||
|
$computer = Get-CimInstance Win32_ComputerSystem
|
||||||
|
if (-not $computer.PartOfDomain -or $computer.DomainRole -ge 4) { return }
|
||||||
|
|
||||||
|
# The domain's Builtin\Administrators group is not the local Administrators
|
||||||
|
# group on a member workstation, even though both have SID S-1-5-32-544.
|
||||||
|
# Resolve its *users* through LDAP, then grant their domain SIDs locally.
|
||||||
|
# The directory lookup must succeed before any local membership is changed.
|
||||||
|
$domainDn = 'DC=' + (($computer.Domain -split '\.') -join ',DC=')
|
||||||
|
$domainAdministratorsDn = "CN=Administrators,CN=Builtin,$domainDn"
|
||||||
|
$directoryRoot = [DirectoryServices.DirectoryEntry]::new("LDAP://$domainDn")
|
||||||
|
$searcher = [DirectoryServices.DirectorySearcher]::new($directoryRoot)
|
||||||
|
$searcher.Filter = "(&(objectCategory=person)(objectClass=user)(memberOf:1.2.840.113556.1.4.1941:=$domainAdministratorsDn))"
|
||||||
|
$searcher.PageSize = 500
|
||||||
|
$searcher.ClientTimeout = [TimeSpan]::FromSeconds(5)
|
||||||
|
$searcher.ServerTimeLimit = [TimeSpan]::FromSeconds(5)
|
||||||
|
[void]$searcher.PropertiesToLoad.Add('objectSid')
|
||||||
|
|
||||||
|
try {
|
||||||
|
$results = $searcher.FindAll()
|
||||||
|
try {
|
||||||
|
$desiredSids = @(
|
||||||
|
foreach ($result in $results) {
|
||||||
|
$sidBytes = [byte[]]$result.Properties['objectsid'][0]
|
||||||
|
if ($sidBytes.Length -gt 0) {
|
||||||
|
[Security.Principal.SecurityIdentifier]::new($sidBytes, 0).Value
|
||||||
|
}
|
||||||
|
}
|
||||||
|
) | Sort-Object -Unique
|
||||||
|
}
|
||||||
|
finally { $results.Dispose() }
|
||||||
|
}
|
||||||
|
catch {
|
||||||
|
Write-Warning "Cannot read domain Administrators; local membership was left unchanged: $($_.Exception.Message)"
|
||||||
|
return
|
||||||
|
}
|
||||||
|
finally {
|
||||||
|
$searcher.Dispose()
|
||||||
|
$directoryRoot.Dispose()
|
||||||
|
}
|
||||||
|
|
||||||
|
$localAdministratorsSid = [Security.Principal.SecurityIdentifier]::new('S-1-5-32-544')
|
||||||
|
$localAdministrators = Get-LocalGroup -SID $localAdministratorsSid
|
||||||
|
$group = [ADSI]("WinNT://$env:COMPUTERNAME/$($localAdministrators.Name),group")
|
||||||
|
function Get-MemberSids {
|
||||||
|
@($group.psbase.Invoke('Members') | ForEach-Object {
|
||||||
|
try {
|
||||||
|
$bytes = $_.GetType().InvokeMember('objectSid',
|
||||||
|
[Reflection.BindingFlags]::GetProperty, $null, $_, $null)
|
||||||
|
if ($bytes) {
|
||||||
|
[Security.Principal.SecurityIdentifier]::new([byte[]]$bytes, 0).Value
|
||||||
|
}
|
||||||
|
}
|
||||||
|
catch { }
|
||||||
|
})
|
||||||
|
}
|
||||||
|
|
||||||
|
$statePath = 'HKLM:\SOFTWARE\SGU\WorkstationAdministrators'
|
||||||
|
$managedSids = if (Test-Path -LiteralPath $statePath) {
|
||||||
|
@((Get-ItemProperty -LiteralPath $statePath -Name ManagedSids -ErrorAction SilentlyContinue).ManagedSids)
|
||||||
|
} else { @() }
|
||||||
|
$managedSids = @($managedSids | Where-Object { $_ -match '^S-1-5-21-' } | Sort-Object -Unique)
|
||||||
|
$presentSids = @(Get-MemberSids)
|
||||||
|
|
||||||
|
foreach ($sid in $desiredSids) {
|
||||||
|
if ($presentSids -notcontains $sid) {
|
||||||
|
Add-LocalGroupMember -Group $localAdministrators.Name -Member $sid
|
||||||
|
$presentSids += $sid
|
||||||
|
$managedSids += $sid
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
# Remove only entries previously added by this policy. Other local or domain
|
||||||
|
# administrators remain untouched if they have a separate authorization path.
|
||||||
|
foreach ($sid in @($managedSids | Where-Object { $desiredSids -notcontains $_ })) {
|
||||||
|
if ($presentSids -contains $sid) {
|
||||||
|
Remove-LocalGroupMember -Group $localAdministrators.Name -Member $sid
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
New-Item -Path $statePath -Force | Out-Null
|
||||||
|
$remainingManagedSids = @($managedSids |
|
||||||
|
Where-Object { $desiredSids -contains $_ } | Sort-Object -Unique)
|
||||||
|
if ($remainingManagedSids.Count -gt 0) {
|
||||||
|
$state = @{
|
||||||
|
Path = $statePath
|
||||||
|
Name = 'ManagedSids'
|
||||||
|
PropertyType = 'MultiString'
|
||||||
|
Value = $remainingManagedSids
|
||||||
|
Force = $true
|
||||||
|
}
|
||||||
|
New-ItemProperty @state | Out-Null
|
||||||
|
}
|
||||||
|
else {
|
||||||
|
Remove-ItemProperty -Path $statePath -Name ManagedSids -ErrorAction SilentlyContinue
|
||||||
|
}
|
||||||
|
|
||||||
|
$verifiedSids = @(Get-MemberSids)
|
||||||
|
$missingSids = @($desiredSids | Where-Object { $verifiedSids -notcontains $_ })
|
||||||
|
if ($missingSids.Count -gt 0) {
|
||||||
|
throw "Domain Administrators were not added to local Administrators: $($missingSids -join ', ')"
|
||||||
|
}
|
||||||
@@ -0,0 +1,142 @@
|
|||||||
|
[CmdletBinding()]
|
||||||
|
param(
|
||||||
|
[string]$RemoteDesktopPrincipal = 'LCI\SG-Laboratorio-Usuarios-RDP',
|
||||||
|
[string]$LocalDnsServer = '',
|
||||||
|
[string]$FallbackDnsServer = ''
|
||||||
|
)
|
||||||
|
|
||||||
|
$ErrorActionPreference = 'Stop'
|
||||||
|
$computer = Get-CimInstance Win32_ComputerSystem
|
||||||
|
if (-not $computer.PartOfDomain -or $computer.DomainRole -ne 1) { return }
|
||||||
|
|
||||||
|
# A site-local DNS server is optional. Change only an adapter whose directly
|
||||||
|
# connected subnet contains that server, after verifying its authoritative DNS
|
||||||
|
# answer. Other sites, VPN adapters and Internet-only interfaces are preserved.
|
||||||
|
if ($LocalDnsServer -and $env:COMPUTERNAME -notmatch '^(AF|SD|SI)-') {
|
||||||
|
$dnsBytes = ([Net.IPAddress]::Parse($LocalDnsServer)).GetAddressBytes()
|
||||||
|
foreach ($ip in @(Get-NetIPAddress -AddressFamily IPv4 | Where-Object {
|
||||||
|
$_.AddressState -eq 'Preferred' -and $_.PrefixLength -gt 0 -and $_.PrefixLength -lt 32
|
||||||
|
})) {
|
||||||
|
$ipBytes = ([Net.IPAddress]::Parse($ip.IPAddress)).GetAddressBytes()
|
||||||
|
$sameSubnet = $true
|
||||||
|
for ($bit = 0; $bit -lt $ip.PrefixLength; $bit++) {
|
||||||
|
$mask = 1 -shl (7 - ($bit % 8))
|
||||||
|
$index = [int][Math]::Floor($bit / 8)
|
||||||
|
if (($ipBytes[$index] -band $mask) -ne ($dnsBytes[$index] -band $mask)) {
|
||||||
|
$sameSubnet = $false; break
|
||||||
|
}
|
||||||
|
}
|
||||||
|
if (-not $sameSubnet) { continue }
|
||||||
|
try {
|
||||||
|
$authority = @(Resolve-DnsName -Name $computer.Domain -Type SOA -Server $LocalDnsServer -DnsOnly -ErrorAction Stop |
|
||||||
|
Where-Object { $_.Name -ieq $computer.Domain -and $_.Type -eq 'SOA' })
|
||||||
|
if (-not $authority) { throw 'The DNS server did not return the domain SOA.' }
|
||||||
|
$desiredServers = @($LocalDnsServer)
|
||||||
|
if ($FallbackDnsServer) {
|
||||||
|
[Net.IPAddress]::Parse($FallbackDnsServer) | Out-Null
|
||||||
|
$fallbackAuthority = @(Resolve-DnsName -Name $computer.Domain -Type SOA -Server $FallbackDnsServer -DnsOnly -ErrorAction Stop |
|
||||||
|
Where-Object { $_.Name -ieq $computer.Domain -and $_.Type -eq 'SOA' })
|
||||||
|
if (-not $fallbackAuthority) { throw 'Fallback DNS is not authoritative for this domain.' }
|
||||||
|
$desiredServers += $FallbackDnsServer
|
||||||
|
}
|
||||||
|
$current = (Get-DnsClientServerAddress -InterfaceIndex $ip.InterfaceIndex -AddressFamily IPv4).ServerAddresses
|
||||||
|
if ((@($current) -join ',') -ne ($desiredServers -join ',')) {
|
||||||
|
Set-DnsClientServerAddress -InterfaceIndex $ip.InterfaceIndex -ServerAddresses $desiredServers
|
||||||
|
}
|
||||||
|
Set-DnsClient -InterfaceIndex $ip.InterfaceIndex -RegisterThisConnectionsAddress $true
|
||||||
|
Register-DnsClient
|
||||||
|
} catch { Write-Warning "Site DNS configuration failed: $($_.Exception.Message)" }
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
$terminalKey = 'HKLM:\SYSTEM\CurrentControlSet\Control\Terminal Server'
|
||||||
|
$rdpKey = Join-Path $terminalKey 'WinStations\RDP-Tcp'
|
||||||
|
if ((Get-ItemPropertyValue -Path $terminalKey -Name fDenyTSConnections) -ne 0) {
|
||||||
|
Set-ItemProperty -Path $terminalKey -Name fDenyTSConnections -Value 0
|
||||||
|
}
|
||||||
|
if ((Get-ItemPropertyValue -Path $rdpKey -Name UserAuthentication) -ne 1) {
|
||||||
|
Set-ItemProperty -Path $rdpKey -Name UserAuthentication -Value 1
|
||||||
|
}
|
||||||
|
|
||||||
|
foreach ($name in @('TermService', 'WinRM')) {
|
||||||
|
$service = Get-Service -Name $name
|
||||||
|
if ($service.StartType -ne 'Automatic') { Set-Service -Name $name -StartupType Automatic }
|
||||||
|
if ($service.Status -ne 'Running') { Start-Service -Name $name }
|
||||||
|
}
|
||||||
|
|
||||||
|
# Each domain refresh carries this script through SYSVOL. Apply only the
|
||||||
|
# narrowly scoped inbound rules required by an administrator on the same LAN.
|
||||||
|
$rules = @(
|
||||||
|
@{ Name = 'SGU-Workstation-WinRM-HTTP'; Protocol = 'TCP'; Port = '5985' },
|
||||||
|
@{ Name = 'SGU-Workstation-RDP-TCP'; Protocol = 'TCP'; Port = '3389' },
|
||||||
|
@{ Name = 'SGU-Workstation-RDP-UDP'; Protocol = 'UDP'; Port = '3389' }
|
||||||
|
)
|
||||||
|
foreach ($rule in $rules) {
|
||||||
|
$existing = Get-NetFirewallRule -Name $rule.Name -ErrorAction SilentlyContinue
|
||||||
|
if ($existing) {
|
||||||
|
$port = $existing | Get-NetFirewallPortFilter
|
||||||
|
$address = $existing | Get-NetFirewallAddressFilter
|
||||||
|
$valid = $existing.Enabled -eq 'True' -and $existing.Action -eq 'Allow' -and
|
||||||
|
$existing.Direction -eq 'Inbound' -and $existing.Profile -eq 'Any' -and
|
||||||
|
$port.Protocol -eq $rule.Protocol -and [string]$port.LocalPort -eq $rule.Port -and
|
||||||
|
@($address.RemoteAddress).Count -eq 1 -and $address.RemoteAddress -eq 'LocalSubnet'
|
||||||
|
if ($valid) { continue }
|
||||||
|
$existing | Remove-NetFirewallRule
|
||||||
|
}
|
||||||
|
New-NetFirewallRule -Name $rule.Name -DisplayName $rule.Name -Enabled True `
|
||||||
|
-Direction Inbound -Action Allow -Profile Any -Protocol $rule.Protocol `
|
||||||
|
-LocalPort $rule.Port -RemoteAddress LocalSubnet | Out-Null
|
||||||
|
}
|
||||||
|
|
||||||
|
# WinRM's administrative-template policy creates the listener. This also
|
||||||
|
# restores the Windows PowerShell session endpoint when it was disabled.
|
||||||
|
$listener = @(Get-ChildItem WSMan:\localhost\Listener -ErrorAction SilentlyContinue |
|
||||||
|
Where-Object { $_.Keys -contains 'Transport=HTTP' })
|
||||||
|
$endpoint = Get-PSSessionConfiguration -Name Microsoft.PowerShell -ErrorAction SilentlyContinue
|
||||||
|
$endpointEnabled = Get-Item 'WSMan:\localhost\Plugin\Microsoft.PowerShell\Enabled' -ErrorAction SilentlyContinue
|
||||||
|
if (-not $listener -or -not $endpoint -or $endpointEnabled.Value -eq 'false') {
|
||||||
|
Enable-PSRemoting -Force -SkipNetworkProfileCheck | Out-Null
|
||||||
|
}
|
||||||
|
|
||||||
|
# Native, language-independent rule names. The domain policy also distributes
|
||||||
|
# these rules through the firewall CSE, so background gpupdate can repair them.
|
||||||
|
$managementPatterns = @('RemoteEventLogSvc-*', 'RemoteSvcAdmin-*', 'WMI-*',
|
||||||
|
'RemoteTask-*', 'RemoteFwAdmin-*', 'RVM-*', 'PerfLogsAlerts-*', 'FPS-SMB-In-TCP*')
|
||||||
|
foreach ($pattern in $managementPatterns) {
|
||||||
|
foreach ($nativeRule in @(Get-NetFirewallRule -Name $pattern -ErrorAction SilentlyContinue |
|
||||||
|
Where-Object Direction -eq 'Inbound')) {
|
||||||
|
# Do not try to mutate policy-owned rules in the workstation local store.
|
||||||
|
if ($nativeRule.PolicyStoreSourceType -ne 'Local') { continue }
|
||||||
|
$address = $nativeRule | Get-NetFirewallAddressFilter
|
||||||
|
if ($nativeRule.Enabled -ne 'True' -or $nativeRule.Profile -ne 'Any' -or
|
||||||
|
@($address.RemoteAddress).Count -ne 1 -or $address.RemoteAddress[0] -ne 'LocalSubnet') {
|
||||||
|
$nativeRule | Set-NetFirewallRule -Enabled True -Profile Any -RemoteAddress LocalSubnet
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
$remoteRegistry = Get-Service RemoteRegistry
|
||||||
|
if ($remoteRegistry.StartType -ne 'Manual') { Set-Service RemoteRegistry -StartupType Manual }
|
||||||
|
|
||||||
|
# The built-in local group has a stable SID across Windows display languages.
|
||||||
|
$groupSid = [Security.Principal.SecurityIdentifier]::new('S-1-5-32-555')
|
||||||
|
$groupName = ($groupSid.Translate([Security.Principal.NTAccount]).Value -split '\\', 2)[1]
|
||||||
|
try {
|
||||||
|
$principalSid = ([Security.Principal.NTAccount]::new($RemoteDesktopPrincipal)).Translate(
|
||||||
|
[Security.Principal.SecurityIdentifier]).Value
|
||||||
|
$group = [ADSI]("WinNT://$env:COMPUTERNAME/$groupName,group")
|
||||||
|
$memberSids = @($group.psbase.Invoke('Members') | ForEach-Object {
|
||||||
|
try {
|
||||||
|
$bytes = $_.GetType().InvokeMember('objectSid',
|
||||||
|
[Reflection.BindingFlags]::GetProperty, $null, $_, $null)
|
||||||
|
if ($bytes) { ([Security.Principal.SecurityIdentifier]::new([byte[]]$bytes, 0)).Value }
|
||||||
|
}
|
||||||
|
catch { }
|
||||||
|
})
|
||||||
|
if ($memberSids -notcontains $principalSid) {
|
||||||
|
Add-LocalGroupMember -Group $groupName -Member $principalSid
|
||||||
|
}
|
||||||
|
}
|
||||||
|
catch {
|
||||||
|
# A temporarily unavailable DC must not prevent RDP and WinRM from starting.
|
||||||
|
Write-Warning "Remote Desktop group membership could not be verified: $($_.Exception.Message)"
|
||||||
|
}
|
||||||
@@ -18,12 +18,18 @@ param(
|
|||||||
[PSCredential]$DomainCredential,
|
[PSCredential]$DomainCredential,
|
||||||
[string]$DomainName = 'lci.lasalle.mx',
|
[string]$DomainName = 'lci.lasalle.mx',
|
||||||
[string]$DomainNetbios = 'LCI',
|
[string]$DomainNetbios = 'LCI',
|
||||||
|
[string]$DomainControllerDnsName,
|
||||||
[string]$ComputerOuDn = 'OU=Laboratorio,DC=lci,DC=lasalle,DC=mx',
|
[string]$ComputerOuDn = 'OU=Laboratorio,DC=lci,DC=lasalle,DC=mx',
|
||||||
[string]$NewComputerName,
|
[string]$NewComputerName,
|
||||||
[string]$NetworkInterfaceAlias = 'Ethernet',
|
[string]$NetworkInterfaceAlias = 'Ethernet',
|
||||||
[string[]]$DomainDnsServerAddresses = @('192.168.50.10'),
|
[string[]]$DomainDnsServerAddresses = @('192.168.50.10'),
|
||||||
|
[switch]$DomainDnsConfigured,
|
||||||
|
[ValidateSet('Direct', 'AzureP2S')]
|
||||||
|
[string]$ConnectivityMode = 'Direct',
|
||||||
[string]$RemoteDesktopPrincipal = 'LCI\SG-Laboratorio-Usuarios-RDP',
|
[string]$RemoteDesktopPrincipal = 'LCI\SG-Laboratorio-Usuarios-RDP',
|
||||||
[string]$DotNetRuntimeInstallerPath,
|
[string]$DotNetRuntimeInstallerPath,
|
||||||
|
[string]$RustDeskServerAddress,
|
||||||
|
[string]$RustDeskServerPublicKey,
|
||||||
[switch]$SkipRestart
|
[switch]$SkipRestart
|
||||||
)
|
)
|
||||||
|
|
||||||
@@ -37,9 +43,13 @@ if (-not $principal.IsInRole([Security.Principal.WindowsBuiltInRole]::Administra
|
|||||||
foreach ($scriptName in @(
|
foreach ($scriptName in @(
|
||||||
'Install-CredentialProvider.ps1',
|
'Install-CredentialProvider.ps1',
|
||||||
'Install-SguEnrollmentGuard.ps1',
|
'Install-SguEnrollmentGuard.ps1',
|
||||||
|
'Set-SguStandardLocalUser.ps1',
|
||||||
|
'Set-SguLocalProfileSecurityPolicies.ps1',
|
||||||
'Test-SguClientEnrollment.ps1',
|
'Test-SguClientEnrollment.ps1',
|
||||||
'Repair-SguClientEnrollment.ps1',
|
'Repair-SguClientEnrollment.ps1',
|
||||||
'Enable-LabRemoteAccess.ps1')) {
|
'Enable-LabRemoteAccess.ps1',
|
||||||
|
'Enable-SguClientMonitoring.ps1',
|
||||||
|
'Install-SguRustDeskClient.ps1')) {
|
||||||
if (-not (Test-Path -LiteralPath (Join-Path $PSScriptRoot $scriptName) -PathType Leaf)) {
|
if (-not (Test-Path -LiteralPath (Join-Path $PSScriptRoot $scriptName) -PathType Leaf)) {
|
||||||
throw "$scriptName must be beside Enroll-SguDomainClient.ps1."
|
throw "$scriptName must be beside Enroll-SguDomainClient.ps1."
|
||||||
}
|
}
|
||||||
@@ -49,6 +59,31 @@ $computer = Get-CimInstance Win32_ComputerSystem
|
|||||||
if ($computer.PartOfDomain -and $computer.Domain -ne $DomainName) {
|
if ($computer.PartOfDomain -and $computer.Domain -ne $DomainName) {
|
||||||
throw "The computer is already joined to the unexpected domain $($computer.Domain)."
|
throw "The computer is already joined to the unexpected domain $($computer.Domain)."
|
||||||
}
|
}
|
||||||
|
$domainMembershipHealthy = $false
|
||||||
|
if ($computer.PartOfDomain) {
|
||||||
|
try {
|
||||||
|
$domainMembershipHealthy = [bool](Test-ComputerSecureChannel -ErrorAction Stop)
|
||||||
|
}
|
||||||
|
catch {
|
||||||
|
$domainMembershipHealthy = $false
|
||||||
|
}
|
||||||
|
}
|
||||||
|
if ($computer.PartOfDomain -and -not $domainMembershipHealthy) {
|
||||||
|
if (-not $DomainCredential) {
|
||||||
|
$DomainCredential = Get-Credential `
|
||||||
|
-UserName "$DomainNetbios\Administrator" `
|
||||||
|
-Message "Credential permitted to repair this computer in $DomainName"
|
||||||
|
}
|
||||||
|
$repairServer = if ($DomainControllerDnsName) { $DomainControllerDnsName } else { $DomainName }
|
||||||
|
Write-Warning "The computer names $DomainName but its secure channel is broken. Repairing it against $repairServer."
|
||||||
|
Reset-ComputerMachinePassword -Server $repairServer -Credential $DomainCredential -ErrorAction Stop
|
||||||
|
Restart-Service Netlogon -Force
|
||||||
|
Start-Sleep -Seconds 2
|
||||||
|
$domainMembershipHealthy = [bool](Test-ComputerSecureChannel -ErrorAction Stop)
|
||||||
|
if (-not $domainMembershipHealthy) {
|
||||||
|
throw "The secure channel to $DomainName remained invalid after repair."
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
$installParams = @{
|
$installParams = @{
|
||||||
PublishPath = $PublishPath
|
PublishPath = $PublishPath
|
||||||
@@ -72,34 +107,80 @@ $guardParams = @{
|
|||||||
TimeoutSeconds = 90
|
TimeoutSeconds = 90
|
||||||
RemoteDesktopPrincipal = $RemoteDesktopPrincipal
|
RemoteDesktopPrincipal = $RemoteDesktopPrincipal
|
||||||
DotNetRuntimeInstallerPath = $DotNetRuntimeInstallerPath
|
DotNetRuntimeInstallerPath = $DotNetRuntimeInstallerPath
|
||||||
|
RustDeskServerAddress = $RustDeskServerAddress
|
||||||
|
RustDeskServerPublicKey = $RustDeskServerPublicKey
|
||||||
}
|
}
|
||||||
|
|
||||||
|
if ([string]::IsNullOrWhiteSpace($RustDeskServerAddress) -xor
|
||||||
|
[string]::IsNullOrWhiteSpace($RustDeskServerPublicKey)) {
|
||||||
|
throw 'RustDeskServerAddress and RustDeskServerPublicKey must be supplied together.'
|
||||||
|
}
|
||||||
|
$rustDeskResult = $null
|
||||||
|
|
||||||
if ($PSCmdlet.ShouldProcess($env:COMPUTERNAME, 'Install and verify SGU before joining the domain')) {
|
if ($PSCmdlet.ShouldProcess($env:COMPUTERNAME, 'Install and verify SGU before joining the domain')) {
|
||||||
# The broker uses a domain DNS name even before the machine joins the
|
# The broker uses a domain DNS name even before the machine joins the
|
||||||
# domain. Point at AD DNS first so the provider-first health check works on
|
# domain. Point at AD DNS first so the provider-first health check works on
|
||||||
# a completely clean Windows installation.
|
# a completely clean Windows installation.
|
||||||
Set-DnsClientServerAddress `
|
if ($DomainDnsConfigured) {
|
||||||
-InterfaceAlias $NetworkInterfaceAlias `
|
# The bootstrap configured domain-scoped NRPT, preserving Internet DNS.
|
||||||
-ServerAddresses $DomainDnsServerAddresses
|
}
|
||||||
|
elseif ($ConnectivityMode -eq 'Direct') {
|
||||||
|
Set-DnsClientServerAddress `
|
||||||
|
-InterfaceAlias $NetworkInterfaceAlias `
|
||||||
|
-ServerAddresses $DomainDnsServerAddresses
|
||||||
|
}
|
||||||
|
else {
|
||||||
|
$nrptDisplayName = "SGU Azure P2S DNS - $DomainName"
|
||||||
|
$nrptRule = Get-DnsClientNrptRule -ErrorAction SilentlyContinue |
|
||||||
|
Where-Object DisplayName -eq $nrptDisplayName |
|
||||||
|
Select-Object -First 1
|
||||||
|
if (-not $nrptRule -or
|
||||||
|
@($DomainDnsServerAddresses | Where-Object { @($nrptRule.NameServers) -contains $_ }).Count -eq 0) {
|
||||||
|
throw "AzureP2S enrollment requires the managed NRPT rule '$nrptDisplayName'. Run Install-SguAzureP2sClient.ps1 first."
|
||||||
|
}
|
||||||
|
}
|
||||||
Resolve-DnsName -Type SRV "_ldap._tcp.dc._msdcs.$DomainName" -ErrorAction Stop | Out-Null
|
Resolve-DnsName -Type SRV "_ldap._tcp.dc._msdcs.$DomainName" -ErrorAction Stop | Out-Null
|
||||||
|
|
||||||
& (Join-Path $PSScriptRoot 'Install-CredentialProvider.ps1') @installParams | Out-Null
|
& (Join-Path $PSScriptRoot 'Install-CredentialProvider.ps1') @installParams | Out-Null
|
||||||
|
if ($RustDeskServerAddress) {
|
||||||
|
$rustDeskResult = & (Join-Path $PSScriptRoot 'Install-SguRustDeskClient.ps1') `
|
||||||
|
-ServerAddress $RustDeskServerAddress `
|
||||||
|
-ServerPublicKey $RustDeskServerPublicKey
|
||||||
|
}
|
||||||
|
$localStudentUser = & (Join-Path $PSScriptRoot 'Set-SguStandardLocalUser.ps1')
|
||||||
& (Join-Path $PSScriptRoot 'Install-SguEnrollmentGuard.ps1') @guardParams | Out-Null
|
& (Join-Path $PSScriptRoot 'Install-SguEnrollmentGuard.ps1') @guardParams | Out-Null
|
||||||
|
|
||||||
$preJoin = & (Join-Path $PSScriptRoot 'Test-SguClientEnrollment.ps1') `
|
$testParameters = @{ RequireBrokerHealth = $true }
|
||||||
-RequireBrokerHealth
|
if ($RustDeskServerAddress) {
|
||||||
|
$testParameters.RequireRustDesk = $true
|
||||||
|
$testParameters.RustDeskServerAddress = $RustDeskServerAddress
|
||||||
|
}
|
||||||
|
$preJoin = & (Join-Path $PSScriptRoot 'Test-SguClientEnrollment.ps1') @testParameters
|
||||||
if (-not $preJoin.IsValid) {
|
if (-not $preJoin.IsValid) {
|
||||||
throw "Domain join refused because SGU enrollment is invalid: $($preJoin.Issues -join ' ')"
|
throw "Domain join refused because SGU enrollment is invalid: $($preJoin.Issues -join ' ')"
|
||||||
}
|
}
|
||||||
|
|
||||||
if ($computer.PartOfDomain) {
|
if ($computer.PartOfDomain -and $domainMembershipHealthy) {
|
||||||
& (Join-Path $PSScriptRoot 'Enable-LabRemoteAccess.ps1') `
|
& (Join-Path $PSScriptRoot 'Enable-LabRemoteAccess.ps1') `
|
||||||
-RemoteDesktopPrincipal $RemoteDesktopPrincipal `
|
-RemoteDesktopPrincipal $RemoteDesktopPrincipal `
|
||||||
-EnableAdministrativeFirewallGroups | Out-Null
|
-EnableAdministrativeFirewallGroups | Out-Null
|
||||||
return & (Join-Path $PSScriptRoot 'Test-SguClientEnrollment.ps1') `
|
& (Join-Path $PSScriptRoot 'Enable-SguClientMonitoring.ps1') | Out-Null
|
||||||
-RequireDomainJoined `
|
$postJoinParameters = @{
|
||||||
-RequireRemoteAccess `
|
RequireDomainJoined = $true
|
||||||
-RemoteDesktopPrincipal $RemoteDesktopPrincipal
|
RequireRemoteAccess = $true
|
||||||
|
RemoteDesktopPrincipal = $RemoteDesktopPrincipal
|
||||||
|
}
|
||||||
|
if ($RustDeskServerAddress) {
|
||||||
|
$postJoinParameters.RequireRustDesk = $true
|
||||||
|
$postJoinParameters.RustDeskServerAddress = $RustDeskServerAddress
|
||||||
|
}
|
||||||
|
$postJoin = & (Join-Path $PSScriptRoot 'Test-SguClientEnrollment.ps1') @postJoinParameters
|
||||||
|
if (-not $postJoin.IsValid) {
|
||||||
|
throw "SGU validation failed on the joined computer: $($postJoin.Issues -join ' ')"
|
||||||
|
}
|
||||||
|
$postJoin | Add-Member -NotePropertyName StandardLocalUser -NotePropertyValue $localStudentUser
|
||||||
|
$postJoin | Add-Member -NotePropertyName RustDesk -NotePropertyValue $rustDeskResult
|
||||||
|
return $postJoin
|
||||||
}
|
}
|
||||||
|
|
||||||
if (-not $DomainCredential) {
|
if (-not $DomainCredential) {
|
||||||
@@ -129,6 +210,9 @@ if ($PSCmdlet.ShouldProcess($env:COMPUTERNAME, 'Install and verify SGU before jo
|
|||||||
[pscustomobject]@{
|
[pscustomobject]@{
|
||||||
ComputerName = if ($NewComputerName) { $NewComputerName } else { $env:COMPUTERNAME }
|
ComputerName = if ($NewComputerName) { $NewComputerName } else { $env:COMPUTERNAME }
|
||||||
DomainName = $DomainName
|
DomainName = $DomainName
|
||||||
|
ConnectivityMode = $ConnectivityMode
|
||||||
ProviderValidatedBeforeJoin = $true
|
ProviderValidatedBeforeJoin = $true
|
||||||
|
StandardLocalUser = $localStudentUser
|
||||||
|
RustDesk = $rustDeskResult
|
||||||
RestartRequired = [bool]$SkipRestart
|
RestartRequired = [bool]$SkipRestart
|
||||||
}
|
}
|
||||||
Executable
+518
@@ -0,0 +1,518 @@
|
|||||||
|
#!/usr/bin/env bash
|
||||||
|
# Enroll-SguLinuxDomainClient.sh
|
||||||
|
#
|
||||||
|
# Idempotently joins a Debian/Ubuntu or RHEL-family Linux workstation to the
|
||||||
|
# SGU Active Directory laboratory. The join password is always requested by
|
||||||
|
# realmd; this script never accepts, logs, or stores it.
|
||||||
|
|
||||||
|
set -Eeuo pipefail
|
||||||
|
IFS=$'\n\t'
|
||||||
|
SCRIPT_DIRECTORY=$(cd -- "$(dirname -- "${BASH_SOURCE[0]}")" && pwd)
|
||||||
|
|
||||||
|
DOMAIN_NAME='lci.lasalle.mx'
|
||||||
|
DOMAIN_CONTROLLER=''
|
||||||
|
DOMAIN_DNS=''
|
||||||
|
COMPUTER_OU='OU=Laboratorio,DC=lci,DC=lasalle,DC=mx'
|
||||||
|
JOIN_USER='Administrator'
|
||||||
|
DOMAIN_INTERFACE=''
|
||||||
|
DOMAIN_ADDRESS=''
|
||||||
|
COMPUTER_NAME=''
|
||||||
|
ALLOW_GROUP=''
|
||||||
|
ENABLE_SSH=false
|
||||||
|
ENABLE_HYPERV_ENHANCED_SESSION=false
|
||||||
|
ENABLE_RUSTDESK=true
|
||||||
|
RUSTDESK_REGISTRATION_SHARE=''
|
||||||
|
|
||||||
|
usage() {
|
||||||
|
cat <<'EOF'
|
||||||
|
Usage:
|
||||||
|
sudo ./Enroll-SguLinuxDomainClient.sh --domain-controller <IPv4-or-FQDN> [options]
|
||||||
|
|
||||||
|
Required:
|
||||||
|
--domain-controller VALUE Fixed IPv4 address or DNS name of the AD controller.
|
||||||
|
|
||||||
|
Options:
|
||||||
|
--domain-name VALUE AD DNS domain (default: lci.lasalle.mx).
|
||||||
|
--domain-dns VALUE DNS server for the AD network (default: domain controller).
|
||||||
|
--computer-ou DN Destination computer OU.
|
||||||
|
--join-user USER AD account permitted to join computers (default: Administrator).
|
||||||
|
--computer-name NAME NetBIOS host name; its FQDN becomes NAME.DOMAIN.
|
||||||
|
--domain-interface IFACE Private NIC connected to the AD network.
|
||||||
|
--domain-address CIDR Static IPv4 address for --domain-interface, e.g. 192.168.50.12/24.
|
||||||
|
--allow-group GROUP Restrict Linux sign-in to this AD group after joining.
|
||||||
|
--enable-ssh Install, enable, and (when active) permit OpenSSH in the local firewall.
|
||||||
|
--enable-hyperv-enhanced-session
|
||||||
|
Install and configure XRDP over Hyper-V sockets for VMConnect.
|
||||||
|
--disable-rustdesk Do not install the managed RustDesk remote-support client.
|
||||||
|
--rustdesk-registration-share UNC
|
||||||
|
Override the protected controller SMB enrollment share.
|
||||||
|
--help Show this help.
|
||||||
|
|
||||||
|
Network safety:
|
||||||
|
--domain-interface and --domain-address must be supplied together. The selected
|
||||||
|
interface must not own the default route, so the command cannot replace the
|
||||||
|
Internet route while attaching a private AD NIC.
|
||||||
|
|
||||||
|
The AD password is requested interactively by realmd. It is never accepted as an
|
||||||
|
argument or written to a file, log, or command line.
|
||||||
|
EOF
|
||||||
|
}
|
||||||
|
|
||||||
|
fail() {
|
||||||
|
printf 'ERROR: %s\n' "$*" >&2
|
||||||
|
exit 1
|
||||||
|
}
|
||||||
|
|
||||||
|
need_command() {
|
||||||
|
command -v "$1" >/dev/null 2>&1 || fail "Required command is unavailable: $1"
|
||||||
|
}
|
||||||
|
|
||||||
|
packages_are_installed() {
|
||||||
|
local package_name
|
||||||
|
for package_name in "$@"; do
|
||||||
|
dpkg-query -W -f='${db:Status-Status}' "$package_name" 2>/dev/null | grep -Fxq 'installed' \
|
||||||
|
|| return 1
|
||||||
|
done
|
||||||
|
}
|
||||||
|
|
||||||
|
apt_get_with_retry() {
|
||||||
|
local attempt
|
||||||
|
for attempt in $(seq 1 60); do
|
||||||
|
if apt-get "$@"; then
|
||||||
|
return 0
|
||||||
|
fi
|
||||||
|
if fuser /var/lib/dpkg/lock-frontend /var/lib/dpkg/lock /var/lib/apt/lists/lock \
|
||||||
|
>/dev/null 2>&1; then
|
||||||
|
printf 'Waiting for another package operation before retrying apt-get %s.\n' "$1" >&2
|
||||||
|
sleep 5
|
||||||
|
continue
|
||||||
|
fi
|
||||||
|
fail "apt-get $1 failed for a reason other than a temporary package lock."
|
||||||
|
done
|
||||||
|
fail 'Timed out waiting for another package operation to finish.'
|
||||||
|
}
|
||||||
|
|
||||||
|
while (($#)); do
|
||||||
|
case "$1" in
|
||||||
|
--domain-controller) DOMAIN_CONTROLLER=${2:?Missing value for --domain-controller}; shift 2 ;;
|
||||||
|
--domain-name) DOMAIN_NAME=${2:?Missing value for --domain-name}; shift 2 ;;
|
||||||
|
--domain-dns) DOMAIN_DNS=${2:?Missing value for --domain-dns}; shift 2 ;;
|
||||||
|
--computer-ou) COMPUTER_OU=${2:?Missing value for --computer-ou}; shift 2 ;;
|
||||||
|
--join-user) JOIN_USER=${2:?Missing value for --join-user}; shift 2 ;;
|
||||||
|
--computer-name) COMPUTER_NAME=${2:?Missing value for --computer-name}; shift 2 ;;
|
||||||
|
--domain-interface) DOMAIN_INTERFACE=${2:?Missing value for --domain-interface}; shift 2 ;;
|
||||||
|
--domain-address) DOMAIN_ADDRESS=${2:?Missing value for --domain-address}; shift 2 ;;
|
||||||
|
--allow-group) ALLOW_GROUP=${2:?Missing value for --allow-group}; shift 2 ;;
|
||||||
|
--enable-ssh) ENABLE_SSH=true; shift ;;
|
||||||
|
--enable-hyperv-enhanced-session) ENABLE_HYPERV_ENHANCED_SESSION=true; shift ;;
|
||||||
|
--disable-rustdesk) ENABLE_RUSTDESK=false; shift ;;
|
||||||
|
--rustdesk-registration-share) RUSTDESK_REGISTRATION_SHARE=${2:?Missing value for --rustdesk-registration-share}; shift 2 ;;
|
||||||
|
--help|-h) usage; exit 0 ;;
|
||||||
|
*) fail "Unknown argument: $1. Use --help for usage." ;;
|
||||||
|
esac
|
||||||
|
done
|
||||||
|
|
||||||
|
[[ ${EUID} -eq 0 ]] || fail 'Run this command with sudo or as root.'
|
||||||
|
[[ -n $DOMAIN_CONTROLLER ]] || fail '--domain-controller is required.'
|
||||||
|
|
||||||
|
if [[ -z $DOMAIN_DNS ]]; then
|
||||||
|
DOMAIN_DNS=$DOMAIN_CONTROLLER
|
||||||
|
fi
|
||||||
|
|
||||||
|
if [[ -n $DOMAIN_INTERFACE || -n $DOMAIN_ADDRESS ]]; then
|
||||||
|
[[ -n $DOMAIN_INTERFACE && -n $DOMAIN_ADDRESS ]] || \
|
||||||
|
fail '--domain-interface and --domain-address must be supplied together.'
|
||||||
|
fi
|
||||||
|
|
||||||
|
if [[ -z $COMPUTER_NAME ]]; then
|
||||||
|
COMPUTER_NAME=$(hostname -s)
|
||||||
|
fi
|
||||||
|
COMPUTER_NAME=${COMPUTER_NAME^^}
|
||||||
|
HOST_FQDN="${COMPUTER_NAME,,}.${DOMAIN_NAME,,}"
|
||||||
|
|
||||||
|
install_prerequisites() {
|
||||||
|
local -a packages=()
|
||||||
|
if command -v apt-get >/dev/null 2>&1; then
|
||||||
|
packages=(realmd sssd sssd-tools adcli libnss-sss libpam-sss krb5-user packagekit samba-common-bin)
|
||||||
|
if [[ $ENABLE_SSH == true ]]; then
|
||||||
|
packages+=(openssh-server)
|
||||||
|
fi
|
||||||
|
if [[ $ENABLE_HYPERV_ENHANCED_SESSION == true ]]; then
|
||||||
|
packages+=(xrdp xorgxrdp ssl-cert)
|
||||||
|
|
||||||
|
# XRDP's Debian post-install script cannot replace a dangling
|
||||||
|
# certificate symlink left by an interrupted/older installation.
|
||||||
|
# Remove only dangling links so dpkg can recreate them safely.
|
||||||
|
local xrdp_link
|
||||||
|
for xrdp_link in /etc/xrdp/cert.pem /etc/xrdp/key.pem; do
|
||||||
|
if [[ -L $xrdp_link && ! -e $xrdp_link ]]; then
|
||||||
|
rm -f -- "$xrdp_link"
|
||||||
|
fi
|
||||||
|
done
|
||||||
|
fi
|
||||||
|
export DEBIAN_FRONTEND=noninteractive
|
||||||
|
if ! packages_are_installed "${packages[@]}"; then
|
||||||
|
apt_get_with_retry update
|
||||||
|
apt_get_with_retry install -y "${packages[@]}"
|
||||||
|
fi
|
||||||
|
# `pam-auth-update` takes the debconf database lock even when its
|
||||||
|
# profile is already enabled. Avoid that unnecessary package-manager
|
||||||
|
# dependency on repeat enrollment runs.
|
||||||
|
if ! grep -Eq '^[[:space:]]*[^#].*pam_mkhomedir\.so' /etc/pam.d/common-session; then
|
||||||
|
pam-auth-update --enable mkhomedir --force
|
||||||
|
fi
|
||||||
|
return
|
||||||
|
fi
|
||||||
|
|
||||||
|
if command -v dnf >/dev/null 2>&1; then
|
||||||
|
packages=(realmd sssd sssd-tools adcli oddjob oddjob-mkhomedir samba-common-tools krb5-workstation)
|
||||||
|
if [[ $ENABLE_SSH == true ]]; then
|
||||||
|
packages+=(openssh-server)
|
||||||
|
fi
|
||||||
|
dnf install -y "${packages[@]}"
|
||||||
|
authselect select sssd with-mkhomedir --force
|
||||||
|
return
|
||||||
|
fi
|
||||||
|
|
||||||
|
fail 'Supported package managers are apt-get (Debian/Ubuntu) and dnf (RHEL/Fedora/Rocky/AlmaLinux).'
|
||||||
|
}
|
||||||
|
|
||||||
|
configure_private_ad_interface() {
|
||||||
|
[[ -n $DOMAIN_INTERFACE ]] || return 0
|
||||||
|
need_command nmcli
|
||||||
|
ip link show "$DOMAIN_INTERFACE" >/dev/null 2>&1 || \
|
||||||
|
fail "Network interface does not exist: $DOMAIN_INTERFACE"
|
||||||
|
|
||||||
|
local default_interface
|
||||||
|
default_interface=$(ip route show default | awk 'NR == 1 { print $5 }')
|
||||||
|
if [[ $default_interface == "$DOMAIN_INTERFACE" ]]; then
|
||||||
|
fail "Refusing to reconfigure $DOMAIN_INTERFACE because it owns the default route. Use the private AD NIC."
|
||||||
|
fi
|
||||||
|
|
||||||
|
local connection_name="SGU-Lab-AD-${DOMAIN_INTERFACE}"
|
||||||
|
if ! nmcli -t -f NAME connection show | grep -Fxq "$connection_name"; then
|
||||||
|
nmcli connection add type ethernet ifname "$DOMAIN_INTERFACE" con-name "$connection_name"
|
||||||
|
fi
|
||||||
|
nmcli connection modify "$connection_name" \
|
||||||
|
connection.autoconnect yes \
|
||||||
|
ipv4.method manual \
|
||||||
|
ipv4.addresses "$DOMAIN_ADDRESS" \
|
||||||
|
ipv4.dns "$DOMAIN_DNS" \
|
||||||
|
ipv4.dns-search "$DOMAIN_NAME" \
|
||||||
|
ipv4.never-default yes \
|
||||||
|
ipv6.method ignore
|
||||||
|
nmcli connection up "$connection_name"
|
||||||
|
}
|
||||||
|
|
||||||
|
enable_sssd_dyndns() {
|
||||||
|
[[ -n $DOMAIN_INTERFACE ]] || return 0
|
||||||
|
local configuration_directory='/etc/sssd/conf.d'
|
||||||
|
local configuration_path="${configuration_directory}/90-sgu-dyndns.conf"
|
||||||
|
local temporary_path
|
||||||
|
temporary_path=$(mktemp)
|
||||||
|
printf '%s\n' \
|
||||||
|
"[domain/${DOMAIN_NAME,,}]" \
|
||||||
|
"ad_hostname = ${HOST_FQDN}" \
|
||||||
|
'dyndns_update = True' \
|
||||||
|
'dyndns_update_ptr = True' \
|
||||||
|
"dyndns_iface = ${DOMAIN_INTERFACE}" \
|
||||||
|
'dyndns_refresh_interval = 43200' >"$temporary_path"
|
||||||
|
install -d -o root -g root -m 700 "$configuration_directory"
|
||||||
|
install -o root -g root -m 600 "$temporary_path" "$configuration_path"
|
||||||
|
rm -f "$temporary_path"
|
||||||
|
}
|
||||||
|
|
||||||
|
enable_short_domain_login_names() {
|
||||||
|
local configuration_path='/etc/sssd/sssd.conf'
|
||||||
|
[[ -f $configuration_path ]] || return 0
|
||||||
|
|
||||||
|
# Institutional account names (AL/AD/DO) are unique in this lab and are
|
||||||
|
# the identifiers users already know. Keep UPN logins valid while also
|
||||||
|
# allowing the short form in PAM applications such as XRDP/VMConnect.
|
||||||
|
if grep -Eq '^[[:space:]]*use_fully_qualified_names[[:space:]]*=' "$configuration_path"; then
|
||||||
|
sed -Ei 's/^[[:space:]]*use_fully_qualified_names[[:space:]]*=.*/use_fully_qualified_names = False/' \
|
||||||
|
"$configuration_path"
|
||||||
|
else
|
||||||
|
sed -Ei "/^\[domain\/${DOMAIN_NAME//./\\.}\]$/a use_fully_qualified_names = False" \
|
||||||
|
"$configuration_path"
|
||||||
|
fi
|
||||||
|
chmod 600 "$configuration_path"
|
||||||
|
}
|
||||||
|
|
||||||
|
configure_sssd_responder_mode() {
|
||||||
|
local configuration_path='/etc/sssd/sssd.conf'
|
||||||
|
[[ -f $configuration_path ]] || return 0
|
||||||
|
|
||||||
|
# realmd writes a persistent responder list, while recent Debian-family
|
||||||
|
# packages can enable the same NSS/PAM responders through systemd sockets.
|
||||||
|
# Running both modes makes the sockets fail at boot and can leave graphical
|
||||||
|
# PAM clients unable to contact SSSD reliably. Keep realmd's persistent
|
||||||
|
# responders and disable only the duplicate socket units when they exist.
|
||||||
|
local unit
|
||||||
|
for unit in sssd-nss.socket sssd-pam.socket sssd-pam-priv.socket; do
|
||||||
|
if systemctl list-unit-files "$unit" --no-legend 2>/dev/null | grep -q "^${unit}"; then
|
||||||
|
systemctl disable --now "$unit" >/dev/null 2>&1 || true
|
||||||
|
systemctl reset-failed "$unit" >/dev/null 2>&1 || true
|
||||||
|
fi
|
||||||
|
done
|
||||||
|
}
|
||||||
|
|
||||||
|
configure_graphical_domain_login() {
|
||||||
|
local sssd_configuration_directory='/etc/sssd/conf.d'
|
||||||
|
local temporary_sssd_configuration
|
||||||
|
local interactive_services='+lightdm,+cinnamon-screensaver'
|
||||||
|
if [[ $ENABLE_HYPERV_ENHANCED_SESSION == true ]]; then
|
||||||
|
interactive_services+=',+xrdp-sesman'
|
||||||
|
fi
|
||||||
|
|
||||||
|
temporary_sssd_configuration=$(mktemp)
|
||||||
|
printf '%s\n' \
|
||||||
|
"[domain/${DOMAIN_NAME,,}]" \
|
||||||
|
"ad_gpo_map_interactive = ${interactive_services}" >"$temporary_sssd_configuration"
|
||||||
|
install -d -o root -g root -m 700 "$sssd_configuration_directory"
|
||||||
|
install -o root -g root -m 600 "$temporary_sssd_configuration" \
|
||||||
|
"${sssd_configuration_directory}/91-sgu-graphical-login.conf"
|
||||||
|
rm -f "$temporary_sssd_configuration"
|
||||||
|
rm -f "${sssd_configuration_directory}/91-sgu-xrdp.conf"
|
||||||
|
|
||||||
|
# Do not disclose a list of local/domain accounts at the console. Slick
|
||||||
|
# Greeter still provides the explicit manual prompt needed for a first AD
|
||||||
|
# sign-in (AL/AD/DO identifier and password).
|
||||||
|
if [[ -d /etc/lightdm/lightdm.conf.d ]]; then
|
||||||
|
local temporary_lightdm_configuration
|
||||||
|
temporary_lightdm_configuration=$(mktemp)
|
||||||
|
printf '%s\n' \
|
||||||
|
'[Seat:*]' \
|
||||||
|
'greeter-show-manual-login=true' \
|
||||||
|
'greeter-hide-users=true' >"$temporary_lightdm_configuration"
|
||||||
|
install -o root -g root -m 644 "$temporary_lightdm_configuration" \
|
||||||
|
'/etc/lightdm/lightdm.conf.d/91-sgu-domain-login.conf'
|
||||||
|
rm -f "$temporary_lightdm_configuration"
|
||||||
|
fi
|
||||||
|
}
|
||||||
|
|
||||||
|
enable_ssh() {
|
||||||
|
[[ $ENABLE_SSH == true ]] || return 0
|
||||||
|
local service_name='sshd'
|
||||||
|
if systemctl list-unit-files ssh.service >/dev/null 2>&1; then
|
||||||
|
service_name='ssh'
|
||||||
|
fi
|
||||||
|
systemctl enable --now "$service_name"
|
||||||
|
if command -v ufw >/dev/null 2>&1 && ufw status | grep -q '^Status: active'; then
|
||||||
|
ufw allow OpenSSH
|
||||||
|
elif command -v firewall-cmd >/dev/null 2>&1 && systemctl is-active --quiet firewalld; then
|
||||||
|
firewall-cmd --permanent --add-service=ssh
|
||||||
|
firewall-cmd --reload
|
||||||
|
fi
|
||||||
|
}
|
||||||
|
|
||||||
|
configure_hyperv_enhanced_session() {
|
||||||
|
[[ $ENABLE_HYPERV_ENHANCED_SESSION == true ]] || return 0
|
||||||
|
|
||||||
|
command -v xrdp >/dev/null 2>&1 || {
|
||||||
|
printf 'WARNING: XRDP is unavailable; Hyper-V Enhanced Session was not enabled.\n' >&2
|
||||||
|
return 0
|
||||||
|
}
|
||||||
|
|
||||||
|
local xrdp_configuration='/etc/xrdp/xrdp.ini'
|
||||||
|
[[ -f $xrdp_configuration ]] || {
|
||||||
|
printf 'WARNING: %s is missing; Hyper-V Enhanced Session was not enabled.\n' "$xrdp_configuration" >&2
|
||||||
|
return 0
|
||||||
|
}
|
||||||
|
|
||||||
|
# VMConnect uses AF_VSOCK rather than TCP. Only change the first occurrence,
|
||||||
|
# which belongs to [Globals]; later port entries describe XRDP backends.
|
||||||
|
sed -Ei '0,/^port=.*/s|^port=.*|port=vsock://-1:3389|' "$xrdp_configuration"
|
||||||
|
if grep -q '^use_vsock=' "$xrdp_configuration"; then
|
||||||
|
sed -Ei '0,/^use_vsock=.*/s|^use_vsock=.*|use_vsock=true|' "$xrdp_configuration"
|
||||||
|
else
|
||||||
|
sed -Ei '/^port=vsock:\/\/-1:3389/a use_vsock=true' "$xrdp_configuration"
|
||||||
|
fi
|
||||||
|
sed -Ei '0,/^security_layer=.*/s|^security_layer=.*|security_layer=rdp|' "$xrdp_configuration"
|
||||||
|
sed -Ei '0,/^crypt_level=.*/s|^crypt_level=.*|crypt_level=none|' "$xrdp_configuration"
|
||||||
|
|
||||||
|
# A clean Ubuntu installation can contain XRDP symlinks before the
|
||||||
|
# snake-oil certificate has actually been generated.
|
||||||
|
if [[ ! -s /etc/ssl/certs/ssl-cert-snakeoil.pem || \
|
||||||
|
! -s /etc/ssl/private/ssl-cert-snakeoil.key ]]; then
|
||||||
|
if command -v make-ssl-cert >/dev/null 2>&1; then
|
||||||
|
make-ssl-cert generate-default-snakeoil --force-overwrite
|
||||||
|
else
|
||||||
|
printf 'WARNING: make-ssl-cert is unavailable; XRDP certificate generation was skipped.\n' >&2
|
||||||
|
fi
|
||||||
|
fi
|
||||||
|
usermod -aG ssl-cert xrdp
|
||||||
|
|
||||||
|
# xrdp-sesman (root) and xrdp (the xrdp account) share /run/xrdp. Give the
|
||||||
|
# directory the shared group/mode so the second service can create its PID
|
||||||
|
# file instead of timing out while VMConnect remains at "Connecting".
|
||||||
|
local override_directory='/etc/systemd/system/xrdp-sesman.service.d'
|
||||||
|
local temporary_override
|
||||||
|
temporary_override=$(mktemp)
|
||||||
|
printf '%s\n' \
|
||||||
|
'[Service]' \
|
||||||
|
'Group=xrdp' \
|
||||||
|
'RuntimeDirectory=xrdp' \
|
||||||
|
'RuntimeDirectoryMode=0775' >"$temporary_override"
|
||||||
|
install -d -o root -g root -m 755 "$override_directory"
|
||||||
|
install -o root -g root -m 644 "$temporary_override" \
|
||||||
|
"${override_directory}/sgu-runtime.conf"
|
||||||
|
rm -f "$temporary_override"
|
||||||
|
|
||||||
|
systemctl daemon-reload
|
||||||
|
systemctl enable xrdp xrdp-sesman
|
||||||
|
systemctl restart xrdp
|
||||||
|
systemctl is-active --quiet xrdp
|
||||||
|
systemctl is-active --quiet xrdp-sesman
|
||||||
|
}
|
||||||
|
|
||||||
|
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 ||
|
||||||
|
! -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
|
||||||
|
|
||||||
|
# Desktop branding is optional and must never invalidate an otherwise valid
|
||||||
|
# domain join. Install its distribution-specific dependencies best-effort.
|
||||||
|
if command -v apt-get >/dev/null 2>&1; then
|
||||||
|
if ! apt_get_with_retry install -y imagemagick ldap-utils fontconfig; then
|
||||||
|
printf 'WARNING: Could not install welcome wallpaper dependencies; enrollment remains valid.\n' >&2
|
||||||
|
return 0
|
||||||
|
fi
|
||||||
|
elif command -v dnf >/dev/null 2>&1; then
|
||||||
|
if ! dnf install -y ImageMagick openldap-clients fontconfig; then
|
||||||
|
printf 'WARNING: Could not install welcome wallpaper dependencies; enrollment remains valid.\n' >&2
|
||||||
|
return 0
|
||||||
|
fi
|
||||||
|
fi
|
||||||
|
|
||||||
|
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/"
|
||||||
|
fi
|
||||||
|
|
||||||
|
local base_dn=''
|
||||||
|
local component
|
||||||
|
IFS='.' read -ra domain_components <<<"$DOMAIN_NAME"
|
||||||
|
for component in "${domain_components[@]}"; do
|
||||||
|
if [[ -n $base_dn ]]; then
|
||||||
|
base_dn+=','
|
||||||
|
fi
|
||||||
|
base_dn+="DC=${component}"
|
||||||
|
done
|
||||||
|
|
||||||
|
local temporary_configuration
|
||||||
|
temporary_configuration=$(mktemp)
|
||||||
|
printf 'DOMAIN_CONTROLLER=%q\nDOMAIN_NAME=%q\nBASE_DN=%q\n' \
|
||||||
|
"$DOMAIN_CONTROLLER" "$DOMAIN_NAME" "$base_dn" >"$temporary_configuration"
|
||||||
|
install -o root -g root -m 644 "$temporary_configuration" \
|
||||||
|
"${configuration_directory}/welcome-wallpaper.conf"
|
||||||
|
rm -f "$temporary_configuration"
|
||||||
|
|
||||||
|
local temporary_autostart
|
||||||
|
temporary_autostart=$(mktemp)
|
||||||
|
cat >"$temporary_autostart" <<'EOF'
|
||||||
|
[Desktop Entry]
|
||||||
|
Type=Application
|
||||||
|
Name=SGU welcome wallpaper
|
||||||
|
Comment=Generate a personalized La Salle laboratory welcome wallpaper
|
||||||
|
Exec=/usr/local/lib/sgu-welcome-wallpaper/Set-SguWelcomeWallpaper.sh
|
||||||
|
Terminal=false
|
||||||
|
NoDisplay=true
|
||||||
|
X-GNOME-Autostart-enabled=true
|
||||||
|
X-Cinnamon-Autostart-enabled=true
|
||||||
|
EOF
|
||||||
|
install -o root -g root -m 644 "$temporary_autostart" \
|
||||||
|
"${autostart_directory}/sgu-welcome-wallpaper.desktop"
|
||||||
|
rm -f "$temporary_autostart"
|
||||||
|
}
|
||||||
|
|
||||||
|
install_managed_rustdesk() {
|
||||||
|
[[ $ENABLE_RUSTDESK == true ]] || return 0
|
||||||
|
local installer="${SCRIPT_DIRECTORY}/Install-SguLinuxRustDeskClient.sh"
|
||||||
|
if [[ ! -r $installer ]]; then
|
||||||
|
fail 'The managed Linux RustDesk installer is missing from this bootstrap package.'
|
||||||
|
fi
|
||||||
|
local -a parameters=(--domain-name "$DOMAIN_NAME")
|
||||||
|
if [[ -n $RUSTDESK_REGISTRATION_SHARE ]]; then
|
||||||
|
parameters+=(--registration-share "$RUSTDESK_REGISTRATION_SHARE")
|
||||||
|
fi
|
||||||
|
bash "$installer" "${parameters[@]}"
|
||||||
|
}
|
||||||
|
|
||||||
|
verify_domain_connectivity() {
|
||||||
|
need_command getent
|
||||||
|
getent ahostsv4 "$DOMAIN_CONTROLLER" >/dev/null || \
|
||||||
|
fail "Could not resolve the domain controller: $DOMAIN_CONTROLLER"
|
||||||
|
if command -v resolvectl >/dev/null 2>&1; then
|
||||||
|
resolvectl query --type=SRV "_ldap._tcp.dc._msdcs.${DOMAIN_NAME}" >/dev/null || \
|
||||||
|
fail "AD DNS does not provide _ldap._tcp.dc._msdcs.${DOMAIN_NAME}."
|
||||||
|
fi
|
||||||
|
}
|
||||||
|
|
||||||
|
configure_private_ad_interface
|
||||||
|
install_prerequisites
|
||||||
|
verify_domain_connectivity
|
||||||
|
|
||||||
|
# Establish a canonical host name before adcli creates or refreshes the
|
||||||
|
# computer object, SPNs, and keytab entries.
|
||||||
|
hostnamectl set-hostname "$HOST_FQDN"
|
||||||
|
|
||||||
|
if realm list --name-only 2>/dev/null | grep -Fxqi "$DOMAIN_NAME"; then
|
||||||
|
printf 'Computer is already joined to %s; validating and refreshing configuration.\n' "$DOMAIN_NAME"
|
||||||
|
else
|
||||||
|
realm discover "$DOMAIN_NAME" >/dev/null
|
||||||
|
printf 'Joining %s. realmd will request the password for %s interactively.\n' "$DOMAIN_NAME" "$JOIN_USER"
|
||||||
|
realm join \
|
||||||
|
--membership-software=adcli \
|
||||||
|
--client-software=sssd \
|
||||||
|
--computer-ou="$COMPUTER_OU" \
|
||||||
|
--user="$JOIN_USER" \
|
||||||
|
"$DOMAIN_NAME"
|
||||||
|
fi
|
||||||
|
|
||||||
|
enable_sssd_dyndns
|
||||||
|
enable_short_domain_login_names
|
||||||
|
configure_sssd_responder_mode
|
||||||
|
configure_graphical_domain_login
|
||||||
|
systemctl enable --now sssd
|
||||||
|
sssctl config-check
|
||||||
|
systemctl restart sssd
|
||||||
|
adcli update --domain="$DOMAIN_NAME" --host-fqdn="$HOST_FQDN" --computer-name="$COMPUTER_NAME"
|
||||||
|
adcli testjoin --domain="$DOMAIN_NAME"
|
||||||
|
|
||||||
|
if [[ -n $ALLOW_GROUP ]]; then
|
||||||
|
realm deny --all
|
||||||
|
realm permit --groups "$ALLOW_GROUP"
|
||||||
|
fi
|
||||||
|
|
||||||
|
enable_ssh
|
||||||
|
configure_hyperv_enhanced_session
|
||||||
|
install_welcome_wallpaper
|
||||||
|
install_managed_rustdesk
|
||||||
|
|
||||||
|
printf '\nLinux enrollment completed.\n'
|
||||||
|
printf ' Host: %s\n' "$HOST_FQDN"
|
||||||
|
printf ' Domain: %s\n' "$DOMAIN_NAME"
|
||||||
|
printf ' OU: %s\n' "$COMPUTER_OU"
|
||||||
|
printf ' Login format: %%U@%s\n' "$DOMAIN_NAME"
|
||||||
|
printf ' Welcome wallpaper: generated at each graphical sign-in when the desktop is supported.\n'
|
||||||
|
if [[ $ENABLE_RUSTDESK == true ]]; then
|
||||||
|
printf ' RustDesk: configured and registered in the controller inventory.\n'
|
||||||
|
fi
|
||||||
|
realm list
|
||||||
@@ -0,0 +1,48 @@
|
|||||||
|
#Requires -Version 5.1
|
||||||
|
[CmdletBinding(SupportsShouldProcess)]
|
||||||
|
param(
|
||||||
|
[Parameter(Mandatory)][string]$SubscriptionId,
|
||||||
|
[Parameter(Mandatory)][string]$ResourceGroupName,
|
||||||
|
[Parameter(Mandatory)][string]$VpnGatewayName,
|
||||||
|
[string]$OutputPath = (Join-Path $PSScriptRoot '..\artifacts\azure-p2s\sgu-azure-vpn-client.zip')
|
||||||
|
)
|
||||||
|
|
||||||
|
$ErrorActionPreference = 'Stop'
|
||||||
|
$ProgressPreference = 'SilentlyContinue'
|
||||||
|
if (-not (Get-Command az -ErrorAction SilentlyContinue)) {
|
||||||
|
throw 'Azure CLI is required.'
|
||||||
|
}
|
||||||
|
& az account set --subscription $SubscriptionId --only-show-errors
|
||||||
|
if ($LASTEXITCODE -ne 0) {
|
||||||
|
throw "Could not select Azure subscription $SubscriptionId."
|
||||||
|
}
|
||||||
|
|
||||||
|
if ($PSCmdlet.ShouldProcess($OutputPath, 'Generate and download the Azure P2S client package')) {
|
||||||
|
$downloadUriText = & az network vnet-gateway vpn-client generate `
|
||||||
|
--resource-group $ResourceGroupName `
|
||||||
|
--name $VpnGatewayName `
|
||||||
|
--processor-architecture Amd64 `
|
||||||
|
--authentication-method EAPTLS `
|
||||||
|
--only-show-errors `
|
||||||
|
--output tsv
|
||||||
|
$downloadUriText = ($downloadUriText -join '').Trim()
|
||||||
|
if ($LASTEXITCODE -ne 0 -or [string]::IsNullOrWhiteSpace($downloadUriText)) {
|
||||||
|
throw 'Azure did not generate a P2S client package URL.'
|
||||||
|
}
|
||||||
|
$downloadUri = $null
|
||||||
|
if (-not [uri]::TryCreate($downloadUriText, [UriKind]::Absolute, [ref]$downloadUri) -or
|
||||||
|
$downloadUri.Scheme -ne 'https') {
|
||||||
|
throw 'Azure returned an invalid VPN client package URL.'
|
||||||
|
}
|
||||||
|
$resolvedOutputPath = [IO.Path]::GetFullPath($OutputPath)
|
||||||
|
New-Item -ItemType Directory -Path (Split-Path $resolvedOutputPath -Parent) -Force | Out-Null
|
||||||
|
Invoke-WebRequest -Uri $downloadUri -OutFile $resolvedOutputPath -UseBasicParsing
|
||||||
|
if ((Get-Item -LiteralPath $resolvedOutputPath).Length -lt 1024) {
|
||||||
|
throw 'The downloaded VPN client package is unexpectedly small.'
|
||||||
|
}
|
||||||
|
[pscustomobject]@{
|
||||||
|
PackagePath = $resolvedOutputPath
|
||||||
|
Sha256 = (Get-FileHash -LiteralPath $resolvedOutputPath -Algorithm SHA256).Hash
|
||||||
|
VpnGatewayName = $VpnGatewayName
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,88 @@
|
|||||||
|
#Requires -Version 5.1
|
||||||
|
[CmdletBinding()]
|
||||||
|
param(
|
||||||
|
[datetime]$Since = (Get-Date).AddDays(-183),
|
||||||
|
[datetime]$Until = (Get-Date),
|
||||||
|
[string]$UserName,
|
||||||
|
[ValidateSet('Critical','Error','Warning','Information','Verbose')]
|
||||||
|
[string]$Level,
|
||||||
|
[int[]]$EventId,
|
||||||
|
[string]$Text,
|
||||||
|
[string]$MonitoringRoot = 'C:\ProgramData\SGU\Monitoring',
|
||||||
|
[string]$BrokerEventLogName = 'SGU Auth Broker',
|
||||||
|
[string]$OutputCsv
|
||||||
|
)
|
||||||
|
|
||||||
|
$ErrorActionPreference = 'Stop'
|
||||||
|
$events = [Collections.Generic.List[object]]::new()
|
||||||
|
$eventNames = @{
|
||||||
|
900 = 'BrokerStarted'
|
||||||
|
1000 = 'AuthenticationAuthorized'
|
||||||
|
1001 = 'AuthenticationRejected'
|
||||||
|
1002 = 'AuthenticationUnavailable'
|
||||||
|
1003 = 'AuthenticationInvalidRequest'
|
||||||
|
1100 = 'SguAuthenticationAccepted'
|
||||||
|
1101 = 'SguAuthenticationTimeout'
|
||||||
|
1102 = 'SguAuthenticationNetworkFailure'
|
||||||
|
1200 = 'ProfileEnrichmentCompleted'
|
||||||
|
1201 = 'ProfileHtmlUnexpected'
|
||||||
|
1202 = 'ProfileEnrichmentTimeout'
|
||||||
|
1203 = 'ProfileEnrichmentFailure'
|
||||||
|
1204 = 'ProfilePageUnavailable'
|
||||||
|
1205 = 'ProfilePhotoUnavailable'
|
||||||
|
1206 = 'ProfilePhotoInvalid'
|
||||||
|
1300 = 'DirectorySynchronizationFailure'
|
||||||
|
1301 = 'DirectoryOptionalMetadataFailure'
|
||||||
|
1302 = 'DirectoryGroupMembershipFailure'
|
||||||
|
1303 = 'DirectoryRoleGroupMembershipAdded'
|
||||||
|
1304 = 'DirectoryPasswordChangeDenied'
|
||||||
|
1305 = 'DirectoryPhotoFailure'
|
||||||
|
1306 = 'DirectoryReversiblePasswordEncryptionEnabled'
|
||||||
|
1307 = 'DirectoryReversiblePasswordEncryptionDisabled'
|
||||||
|
}
|
||||||
|
|
||||||
|
# Keep these reads unfiltered. Besides making archived and current logs behave
|
||||||
|
# identically, this avoids the Windows Server 2025 ForwardedEvents query defect.
|
||||||
|
if (Get-WinEvent -ListLog $BrokerEventLogName -ErrorAction SilentlyContinue) {
|
||||||
|
Get-WinEvent -LogName $BrokerEventLogName -ErrorAction SilentlyContinue |
|
||||||
|
Where-Object { $_.TimeCreated -ge $Since -and $_.TimeCreated -le $Until } |
|
||||||
|
ForEach-Object { $events.Add($_) }
|
||||||
|
}
|
||||||
|
|
||||||
|
$brokerArchiveRoot = Join-Path $MonitoringRoot 'Archive\Broker'
|
||||||
|
Get-ChildItem -LiteralPath $brokerArchiveRoot -Filter '*.evtx' -File -ErrorAction SilentlyContinue |
|
||||||
|
Where-Object LastWriteTime -ge $Since.AddDays(-1) |
|
||||||
|
ForEach-Object {
|
||||||
|
try {
|
||||||
|
Get-WinEvent -Path $_.FullName -Oldest -ErrorAction Stop |
|
||||||
|
Where-Object { $_.TimeCreated -ge $Since -and $_.TimeCreated -le $Until } |
|
||||||
|
ForEach-Object { $events.Add($_) }
|
||||||
|
}
|
||||||
|
catch {
|
||||||
|
Write-Warning "Could not read broker archive $($_.FullName): $($_.Exception.Message)"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
$result = @($events | Where-Object {
|
||||||
|
(-not $UserName -or $_.Message -like "*$UserName*") -and
|
||||||
|
(-not $Level -or $_.LevelDisplayName -eq $Level) -and
|
||||||
|
(-not $EventId -or $_.Id -in $EventId) -and
|
||||||
|
(-not $Text -or $_.Message -like "*$Text*")
|
||||||
|
} | Sort-Object TimeCreated -Descending | ForEach-Object {
|
||||||
|
[pscustomobject]@{
|
||||||
|
TimeCreated = $_.TimeCreated
|
||||||
|
Level = $_.LevelDisplayName
|
||||||
|
EventId = $_.Id
|
||||||
|
EventName = $eventNames[[int]$_.Id]
|
||||||
|
Provider = $_.ProviderName
|
||||||
|
Message = $_.Message
|
||||||
|
}
|
||||||
|
})
|
||||||
|
|
||||||
|
if ($OutputCsv) {
|
||||||
|
$resolvedOutput = [IO.Path]::GetFullPath($OutputCsv)
|
||||||
|
New-Item -ItemType Directory -Path (Split-Path $resolvedOutput -Parent) -Force | Out-Null
|
||||||
|
$result | Export-Csv -LiteralPath $resolvedOutput -NoTypeInformation -Encoding UTF8
|
||||||
|
}
|
||||||
|
|
||||||
|
$result
|
||||||
@@ -0,0 +1,71 @@
|
|||||||
|
[CmdletBinding()]
|
||||||
|
param(
|
||||||
|
[string]$ComputerName,
|
||||||
|
[switch]$RevealPassword,
|
||||||
|
[string]$InventoryRoot = "$env:ProgramData\SGU\RustDesk\Devices"
|
||||||
|
)
|
||||||
|
|
||||||
|
$ErrorActionPreference = 'Stop'
|
||||||
|
|
||||||
|
function Assert-Administrator {
|
||||||
|
$identity = [Security.Principal.WindowsIdentity]::GetCurrent()
|
||||||
|
$principal = [Security.Principal.WindowsPrincipal]::new($identity)
|
||||||
|
if (-not $principal.IsInRole([Security.Principal.WindowsBuiltInRole]::Administrator)) {
|
||||||
|
throw 'Only a local administrator can read the RustDesk device inventory.'
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
function Initialize-DataProtection {
|
||||||
|
if (-not ('SguRustDeskDataProtection' -as [type])) {
|
||||||
|
Add-Type -TypeDefinition @'
|
||||||
|
using System;
|
||||||
|
using System.ComponentModel;
|
||||||
|
using System.Runtime.InteropServices;
|
||||||
|
public static class SguRustDeskDataProtection {
|
||||||
|
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
|
||||||
|
private struct DataBlob { public int cbData; public IntPtr pbData; }
|
||||||
|
[DllImport("crypt32.dll", SetLastError = true, CharSet = CharSet.Unicode)]
|
||||||
|
private static extern bool CryptProtectData(ref DataBlob input, string description, IntPtr entropy, IntPtr reserved, IntPtr prompt, int flags, out DataBlob output);
|
||||||
|
[DllImport("crypt32.dll", SetLastError = true, CharSet = CharSet.Unicode)]
|
||||||
|
private static extern bool CryptUnprotectData(ref DataBlob input, IntPtr description, IntPtr entropy, IntPtr reserved, IntPtr prompt, int flags, out DataBlob output);
|
||||||
|
[DllImport("kernel32.dll", SetLastError = true)] private static extern IntPtr LocalFree(IntPtr memory);
|
||||||
|
private const int CryptProtectLocalMachine = 0x4;
|
||||||
|
private static DataBlob ToBlob(byte[] value) { var blob = new DataBlob { cbData = value.Length, pbData = IntPtr.Zero }; if (value.Length > 0) { blob.pbData = Marshal.AllocHGlobal(value.Length); Marshal.Copy(value, 0, blob.pbData, value.Length); } return blob; }
|
||||||
|
private static byte[] FromBlob(DataBlob blob) { var value = new byte[blob.cbData]; if (blob.cbData > 0) Marshal.Copy(blob.pbData, value, 0, blob.cbData); return value; }
|
||||||
|
public static byte[] Protect(byte[] value) { var input = ToBlob(value); var output = new DataBlob(); try { if (!CryptProtectData(ref input, null, IntPtr.Zero, IntPtr.Zero, IntPtr.Zero, CryptProtectLocalMachine, out output)) throw new Win32Exception(Marshal.GetLastWin32Error()); return FromBlob(output); } finally { if (input.pbData != IntPtr.Zero) Marshal.FreeHGlobal(input.pbData); if (output.pbData != IntPtr.Zero) LocalFree(output.pbData); } }
|
||||||
|
public static byte[] Unprotect(byte[] value) { var input = ToBlob(value); var output = new DataBlob(); try { if (!CryptUnprotectData(ref input, IntPtr.Zero, IntPtr.Zero, IntPtr.Zero, IntPtr.Zero, 0, out output)) throw new Win32Exception(Marshal.GetLastWin32Error()); return FromBlob(output); } finally { if (input.pbData != IntPtr.Zero) Marshal.FreeHGlobal(input.pbData); if (output.pbData != IntPtr.Zero) LocalFree(output.pbData); } }
|
||||||
|
}
|
||||||
|
'@ -ErrorAction Stop
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
Assert-Administrator
|
||||||
|
Initialize-DataProtection
|
||||||
|
if (-not (Test-Path -LiteralPath $InventoryRoot -PathType Container)) {
|
||||||
|
return @()
|
||||||
|
}
|
||||||
|
|
||||||
|
$entries = @(Get-ChildItem -LiteralPath $InventoryRoot -Filter '*.json' -File |
|
||||||
|
ForEach-Object {
|
||||||
|
$metadata = Get-Content -LiteralPath $_.FullName -Raw | ConvertFrom-Json
|
||||||
|
if ($ComputerName -and -not $metadata.ComputerName.Equals($ComputerName, [StringComparison]::OrdinalIgnoreCase)) {
|
||||||
|
return
|
||||||
|
}
|
||||||
|
$result = [ordered]@{
|
||||||
|
ComputerName = [string]$metadata.ComputerName
|
||||||
|
RustDeskId = [string]$metadata.RustDeskId
|
||||||
|
RegisteredAt = [datetime]$metadata.RegisteredAt
|
||||||
|
}
|
||||||
|
if ($RevealPassword) {
|
||||||
|
$secretPath = [string]$metadata.SecretPath
|
||||||
|
if (-not (Test-Path -LiteralPath $secretPath -PathType Leaf)) {
|
||||||
|
throw "The protected RustDesk credential for $($metadata.ComputerName) is missing."
|
||||||
|
}
|
||||||
|
$result.AccessPassword = [Text.Encoding]::UTF8.GetString(
|
||||||
|
[SguRustDeskDataProtection]::Unprotect(
|
||||||
|
[IO.File]::ReadAllBytes($secretPath)))
|
||||||
|
}
|
||||||
|
[pscustomobject]$result
|
||||||
|
})
|
||||||
|
|
||||||
|
$entries | Sort-Object ComputerName
|
||||||
@@ -0,0 +1,176 @@
|
|||||||
|
#Requires -Version 5.1
|
||||||
|
[CmdletBinding()]
|
||||||
|
param(
|
||||||
|
[datetime]$Since = (Get-Date).AddDays(-183),
|
||||||
|
[datetime]$Until = (Get-Date),
|
||||||
|
[string]$UserName,
|
||||||
|
[string]$ComputerName,
|
||||||
|
[string]$MonitoringRoot = 'C:\ProgramData\SGU\Monitoring',
|
||||||
|
[string]$OutputCsv
|
||||||
|
)
|
||||||
|
|
||||||
|
$ErrorActionPreference = 'Stop'
|
||||||
|
$eventIds = @(4624,4625,4634,4647,4778,4779,6005,6006,6008)
|
||||||
|
$events = [Collections.Generic.List[object]]::new()
|
||||||
|
|
||||||
|
try {
|
||||||
|
# Windows Server 2025 can crash the Windows Event Log service when a
|
||||||
|
# structured query is evaluated against ForwardedEvents (wevtsvc.dll,
|
||||||
|
# exception 0xc0000420). Read the channel without a server-side query and
|
||||||
|
# apply every predicate in this process instead.
|
||||||
|
Get-WinEvent -LogName 'ForwardedEvents' -ErrorAction Stop |
|
||||||
|
Where-Object {
|
||||||
|
$_.Id -in $eventIds -and
|
||||||
|
$_.TimeCreated -ge $Since -and
|
||||||
|
$_.TimeCreated -le $Until
|
||||||
|
} |
|
||||||
|
ForEach-Object { $events.Add($_) }
|
||||||
|
}
|
||||||
|
catch [System.Exception] {
|
||||||
|
if ($_.FullyQualifiedErrorId -notlike 'NoMatchingEventsFound*') {
|
||||||
|
Write-Verbose $_.Exception.Message
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
$archiveRoot = Join-Path $MonitoringRoot 'Archive'
|
||||||
|
Get-ChildItem -LiteralPath $archiveRoot -Filter '*.evtx' -File -ErrorAction SilentlyContinue |
|
||||||
|
Where-Object LastWriteTime -ge $Since.AddDays(-1) |
|
||||||
|
ForEach-Object {
|
||||||
|
try {
|
||||||
|
Get-WinEvent -Path $_.FullName -Oldest -ErrorAction Stop |
|
||||||
|
Where-Object { $_.Id -in $eventIds -and $_.TimeCreated -ge $Since -and $_.TimeCreated -le $Until } |
|
||||||
|
ForEach-Object { $events.Add($_) }
|
||||||
|
}
|
||||||
|
catch {
|
||||||
|
Write-Warning "Could not read archive $($_.FullName): $($_.Exception.Message)"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
function Get-EventData {
|
||||||
|
param([Parameter(Mandatory)]$EventRecord)
|
||||||
|
|
||||||
|
$xml = [xml]$EventRecord.ToXml()
|
||||||
|
$data = @{}
|
||||||
|
foreach ($item in @($xml.Event.EventData.Data)) {
|
||||||
|
if ($item.Name) {
|
||||||
|
$data[[string]$item.Name] = [string]$item.'#text'
|
||||||
|
}
|
||||||
|
}
|
||||||
|
[pscustomobject]@{
|
||||||
|
Computer = [string]$xml.Event.System.Computer
|
||||||
|
Data = $data
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
$openSessions = @{}
|
||||||
|
$rows = [Collections.Generic.List[object]]::new()
|
||||||
|
$ignoredUsers = @('ANONYMOUS LOGON','DWM-1','DWM-2','DWM-3','LOCAL SERVICE','NETWORK SERVICE','SYSTEM','UMFD-0','UMFD-1','UMFD-2','UMFD-3')
|
||||||
|
|
||||||
|
foreach ($eventRecord in @($events | Sort-Object TimeCreated,RecordId)) {
|
||||||
|
$parsed = Get-EventData -EventRecord $eventRecord
|
||||||
|
$machine = ($parsed.Computer -split '\.')[0].ToUpperInvariant()
|
||||||
|
$data = $parsed.Data
|
||||||
|
|
||||||
|
if ($eventRecord.Id -in 6005,6006,6008) {
|
||||||
|
foreach ($key in @($openSessions.Keys | Where-Object { $_ -like "$machine|*" })) {
|
||||||
|
$session = $openSessions[$key]
|
||||||
|
$rows.Add([pscustomobject]@{
|
||||||
|
User = $session.User
|
||||||
|
Computer = $machine
|
||||||
|
StartedAt = $session.StartedAt
|
||||||
|
EndedAt = $eventRecord.TimeCreated
|
||||||
|
Duration = $eventRecord.TimeCreated - $session.StartedAt
|
||||||
|
DurationMinutes = [math]::Round(($eventRecord.TimeCreated - $session.StartedAt).TotalMinutes, 2)
|
||||||
|
LogonType = $session.LogonType
|
||||||
|
Result = 'Interrumpida por apagado o reinicio'
|
||||||
|
FailureStatus = $null
|
||||||
|
})
|
||||||
|
$openSessions.Remove($key)
|
||||||
|
}
|
||||||
|
continue
|
||||||
|
}
|
||||||
|
|
||||||
|
if ($eventRecord.Id -eq 4625) {
|
||||||
|
$failedUser = [string]$data.TargetUserName
|
||||||
|
if ($failedUser -and $failedUser -notlike '*$' -and $failedUser.ToUpperInvariant() -notin $ignoredUsers) {
|
||||||
|
$rows.Add([pscustomobject]@{
|
||||||
|
User = if ($data.TargetDomainName) { "$($data.TargetDomainName)\$failedUser" } else { $failedUser }
|
||||||
|
Computer = $machine
|
||||||
|
StartedAt = $eventRecord.TimeCreated
|
||||||
|
EndedAt = $eventRecord.TimeCreated
|
||||||
|
Duration = [timespan]::Zero
|
||||||
|
DurationMinutes = 0
|
||||||
|
LogonType = [string]$data.LogonType
|
||||||
|
Result = 'Fallida'
|
||||||
|
FailureStatus = "$($data.Status)/$($data.SubStatus)"
|
||||||
|
})
|
||||||
|
}
|
||||||
|
continue
|
||||||
|
}
|
||||||
|
|
||||||
|
if ($eventRecord.Id -eq 4624) {
|
||||||
|
$logonType = [string]$data.LogonType
|
||||||
|
$targetUser = [string]$data.TargetUserName
|
||||||
|
if ($logonType -notin @('2','10','11') -or -not $targetUser -or $targetUser -like '*$' -or
|
||||||
|
$targetUser.ToUpperInvariant() -in $ignoredUsers) {
|
||||||
|
continue
|
||||||
|
}
|
||||||
|
$logonId = [string]$data.TargetLogonId
|
||||||
|
$key = "$machine|$logonId"
|
||||||
|
$openSessions[$key] = [pscustomobject]@{
|
||||||
|
User = if ($data.TargetDomainName) { "$($data.TargetDomainName)\$targetUser" } else { $targetUser }
|
||||||
|
StartedAt = $eventRecord.TimeCreated
|
||||||
|
LogonType = $logonType
|
||||||
|
}
|
||||||
|
continue
|
||||||
|
}
|
||||||
|
|
||||||
|
if ($eventRecord.Id -in 4634,4647) {
|
||||||
|
$logonId = if ($eventRecord.Id -eq 4634) { [string]$data.TargetLogonId } else { [string]$data.SubjectLogonId }
|
||||||
|
$key = "$machine|$logonId"
|
||||||
|
if ($openSessions.ContainsKey($key)) {
|
||||||
|
$session = $openSessions[$key]
|
||||||
|
$rows.Add([pscustomobject]@{
|
||||||
|
User = $session.User
|
||||||
|
Computer = $machine
|
||||||
|
StartedAt = $session.StartedAt
|
||||||
|
EndedAt = $eventRecord.TimeCreated
|
||||||
|
Duration = $eventRecord.TimeCreated - $session.StartedAt
|
||||||
|
DurationMinutes = [math]::Round(($eventRecord.TimeCreated - $session.StartedAt).TotalMinutes, 2)
|
||||||
|
LogonType = $session.LogonType
|
||||||
|
Result = 'Completada'
|
||||||
|
FailureStatus = $null
|
||||||
|
})
|
||||||
|
$openSessions.Remove($key)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
foreach ($key in $openSessions.Keys) {
|
||||||
|
$session = $openSessions[$key]
|
||||||
|
$machine = ($key -split '\|', 2)[0]
|
||||||
|
$rows.Add([pscustomobject]@{
|
||||||
|
User = $session.User
|
||||||
|
Computer = $machine
|
||||||
|
StartedAt = $session.StartedAt
|
||||||
|
EndedAt = $null
|
||||||
|
Duration = $Until - $session.StartedAt
|
||||||
|
DurationMinutes = [math]::Round(($Until - $session.StartedAt).TotalMinutes, 2)
|
||||||
|
LogonType = $session.LogonType
|
||||||
|
Result = 'Sesión posiblemente activa'
|
||||||
|
FailureStatus = $null
|
||||||
|
})
|
||||||
|
}
|
||||||
|
|
||||||
|
$result = @($rows | Where-Object {
|
||||||
|
(-not $UserName -or $_.User -like "*$UserName*") -and
|
||||||
|
(-not $ComputerName -or $_.Computer -like "*$ComputerName*")
|
||||||
|
} | Sort-Object StartedAt -Descending)
|
||||||
|
|
||||||
|
if ($OutputCsv) {
|
||||||
|
$resolvedOutput = [IO.Path]::GetFullPath($OutputCsv)
|
||||||
|
New-Item -ItemType Directory -Path (Split-Path $resolvedOutput -Parent) -Force | Out-Null
|
||||||
|
$result | Export-Csv -LiteralPath $resolvedOutput -NoTypeInformation -Encoding UTF8
|
||||||
|
}
|
||||||
|
|
||||||
|
$result
|
||||||
@@ -0,0 +1,39 @@
|
|||||||
|
[CmdletBinding()]
|
||||||
|
param(
|
||||||
|
[string[]]$ComputerName,
|
||||||
|
[PSCredential]$Credential,
|
||||||
|
[string]$DomainController = $env:COMPUTERNAME,
|
||||||
|
[switch]$RefreshPolicy
|
||||||
|
)
|
||||||
|
$ErrorActionPreference = 'Stop'
|
||||||
|
if (-not $ComputerName) {
|
||||||
|
Import-Module ActiveDirectory
|
||||||
|
$ComputerName = @(Get-ADComputer -Server $DomainController -Filter 'Enabled -eq $true' -Properties OperatingSystem,DNSHostName |
|
||||||
|
Where-Object { $_.DNSHostName -and $_.OperatingSystem -like 'Windows*' -and $_.OperatingSystem -notlike '*Server*' } |
|
||||||
|
Select-Object -ExpandProperty DNSHostName)
|
||||||
|
}
|
||||||
|
foreach ($name in $ComputerName) {
|
||||||
|
try {
|
||||||
|
$parameters = @{ComputerName=$name;Authentication='Kerberos';ErrorAction='Stop';
|
||||||
|
SessionOption=(New-PSSessionOption -OpenTimeout 10000 -OperationTimeout 90000)}
|
||||||
|
if ($Credential) { $parameters.Credential = $Credential }
|
||||||
|
Invoke-Command @parameters -ArgumentList ([bool]$RefreshPolicy) -ScriptBlock {
|
||||||
|
param($refresh)
|
||||||
|
$exitCode = $null
|
||||||
|
if ($refresh) { gpupdate /target:computer /force /wait:60 | Out-Null; $exitCode=$LASTEXITCODE }
|
||||||
|
$rules = @(Get-NetFirewallRule -PolicyStore ActiveStore -Name 'LaSalle-Management-*' -ErrorAction SilentlyContinue |
|
||||||
|
Where-Object { $_.PolicyStoreSourceType -eq 'GroupPolicy' -and $_.Enabled -eq 'True' })
|
||||||
|
$applied = @(Get-CimInstance -Namespace root\RSOP\Computer -ClassName RSOP_GPO)
|
||||||
|
[pscustomobject]@{
|
||||||
|
Name=$env:COMPUTERNAME; Reachable=$true; SecureChannel=(Test-ComputerSecureChannel)
|
||||||
|
PolicyApplied=($applied.Name -contains 'La Salle - Workstation remote management')
|
||||||
|
RdpEnabled=((Get-ItemPropertyValue 'HKLM:\SYSTEM\CurrentControlSet\Control\Terminal Server' -Name fDenyTSConnections) -eq 0)
|
||||||
|
NLA=((Get-ItemPropertyValue 'HKLM:\SYSTEM\CurrentControlSet\Control\Terminal Server\WinStations\RDP-Tcp' -Name UserAuthentication) -eq 1)
|
||||||
|
WinRM=[string](Get-Service WinRM).Status; RdpService=[string](Get-Service TermService).Status
|
||||||
|
PolicyFirewallRules=$rules.Count; GpUpdateExit=$exitCode
|
||||||
|
}
|
||||||
|
} | Select-Object Name,Reachable,SecureChannel,PolicyApplied,RdpEnabled,NLA,WinRM,RdpService,PolicyFirewallRules,GpUpdateExit
|
||||||
|
} catch {
|
||||||
|
[pscustomobject]@{Name=$name;Reachable=$false;Error=$_.Exception.Message}
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -6,10 +6,15 @@ param(
|
|||||||
[int]$PrefixLength = 24,
|
[int]$PrefixLength = 24,
|
||||||
[string]$NetworkInterfaceAlias,
|
[string]$NetworkInterfaceAlias,
|
||||||
[ipaddress]$DefaultGateway,
|
[ipaddress]$DefaultGateway,
|
||||||
|
[ValidateSet('GuestStatic', 'PlatformManaged')]
|
||||||
|
[string]$NetworkConfigurationMode = 'GuestStatic',
|
||||||
|
[string[]]$TrustedClientNetworks = @(),
|
||||||
|
[string[]]$PublicEnrollmentNetworks = @(),
|
||||||
[ipaddress[]]$DnsForwarders = @(),
|
[ipaddress[]]$DnsForwarders = @(),
|
||||||
[string]$DomainName = 'lci.lasalle.mx',
|
[string]$DomainName = 'lci.lasalle.mx',
|
||||||
[string]$DomainNetbios = 'LCI',
|
[string]$DomainNetbios = 'LCI',
|
||||||
[string]$BrokerRecordName = 'sgu-auth',
|
[string]$BrokerRecordName = 'sgu-auth',
|
||||||
|
[string]$RustDeskRecordName = 'rustdesk',
|
||||||
[string]$PackageSharePath = 'C:\Packages',
|
[string]$PackageSharePath = 'C:\Packages',
|
||||||
[securestring]$SafeModeAdministratorPassword,
|
[securestring]$SafeModeAdministratorPassword,
|
||||||
[switch]$SkipRestart,
|
[switch]$SkipRestart,
|
||||||
@@ -68,6 +73,135 @@ function Get-DomainBaseDn {
|
|||||||
return (($DnsDomainName -split '\.') | ForEach-Object { "DC=$_" }) -join ','
|
return (($DnsDomainName -split '\.') | ForEach-Object { "DC=$_" }) -join ','
|
||||||
}
|
}
|
||||||
|
|
||||||
|
function Test-PrivateIPv4Address {
|
||||||
|
param([Parameter(Mandatory)][ipaddress]$Address)
|
||||||
|
|
||||||
|
if ($Address.AddressFamily -ne [Net.Sockets.AddressFamily]::InterNetwork) {
|
||||||
|
return $false
|
||||||
|
}
|
||||||
|
$bytes = $Address.GetAddressBytes()
|
||||||
|
return $bytes[0] -eq 10 -or
|
||||||
|
($bytes[0] -eq 172 -and $bytes[1] -ge 16 -and $bytes[1] -le 31) -or
|
||||||
|
($bytes[0] -eq 192 -and $bytes[1] -eq 168)
|
||||||
|
}
|
||||||
|
|
||||||
|
function ConvertTo-NetworkCidr {
|
||||||
|
param(
|
||||||
|
[Parameter(Mandatory)][ipaddress]$Address,
|
||||||
|
[Parameter(Mandatory)][ValidateRange(1, 32)][int]$NetworkPrefixLength
|
||||||
|
)
|
||||||
|
|
||||||
|
if ($Address.AddressFamily -ne [Net.Sockets.AddressFamily]::InterNetwork) {
|
||||||
|
throw 'Only IPv4 networks are supported by the SGU bootstrap.'
|
||||||
|
}
|
||||||
|
$addressBytes = $Address.GetAddressBytes()
|
||||||
|
$networkBytes = [byte[]]::new(4)
|
||||||
|
$remainingBits = $NetworkPrefixLength
|
||||||
|
for ($index = 0; $index -lt 4; $index++) {
|
||||||
|
$mask = if ($remainingBits -ge 8) {
|
||||||
|
255
|
||||||
|
}
|
||||||
|
elseif ($remainingBits -le 0) {
|
||||||
|
0
|
||||||
|
}
|
||||||
|
else {
|
||||||
|
256 - [Math]::Pow(2, 8 - $remainingBits)
|
||||||
|
}
|
||||||
|
$networkBytes[$index] = [byte]($addressBytes[$index] -band [int]$mask)
|
||||||
|
$remainingBits -= 8
|
||||||
|
}
|
||||||
|
return "$(($networkBytes | ForEach-Object { [string]$_ }) -join '.')/$NetworkPrefixLength"
|
||||||
|
}
|
||||||
|
|
||||||
|
function ConvertTo-PrivateNetworkCidr {
|
||||||
|
param([Parameter(Mandatory)][string]$Cidr)
|
||||||
|
|
||||||
|
if ($Cidr -notmatch '^([^/]+)/(\d{1,2})$') {
|
||||||
|
throw "Trusted client network '$Cidr' must use IPv4 CIDR notation, for example 172.30.0.0/24."
|
||||||
|
}
|
||||||
|
$address = $null
|
||||||
|
if (-not [ipaddress]::TryParse($Matches[1], [ref]$address) -or
|
||||||
|
$address.AddressFamily -ne [Net.Sockets.AddressFamily]::InterNetwork) {
|
||||||
|
throw "Trusted client network '$Cidr' is not a valid IPv4 network."
|
||||||
|
}
|
||||||
|
$networkPrefixLength = [int]$Matches[2]
|
||||||
|
if ($networkPrefixLength -lt 1 -or $networkPrefixLength -gt 32) {
|
||||||
|
throw "Trusted client network '$Cidr' has an invalid prefix length."
|
||||||
|
}
|
||||||
|
if (-not (Test-PrivateIPv4Address -Address $address)) {
|
||||||
|
throw "Trusted client network '$Cidr' is not private RFC1918 space. The bootstrap never exposes AD services to public client addresses."
|
||||||
|
}
|
||||||
|
return ConvertTo-NetworkCidr -Address $address -NetworkPrefixLength $networkPrefixLength
|
||||||
|
}
|
||||||
|
|
||||||
|
function ConvertTo-PublicNetworkCidr {
|
||||||
|
param([Parameter(Mandatory)][string]$Cidr)
|
||||||
|
|
||||||
|
if ($Cidr -notmatch '^([^/]+)/(\d{1,2})$') {
|
||||||
|
throw "Public enrollment network '$Cidr' must use IPv4 CIDR notation, for example 203.0.113.0/24."
|
||||||
|
}
|
||||||
|
$address = $null
|
||||||
|
if (-not [ipaddress]::TryParse($Matches[1], [ref]$address) -or
|
||||||
|
$address.AddressFamily -ne [Net.Sockets.AddressFamily]::InterNetwork) {
|
||||||
|
throw "Public enrollment network '$Cidr' is not a valid IPv4 network."
|
||||||
|
}
|
||||||
|
$networkPrefixLength = [int]$Matches[2]
|
||||||
|
if ($networkPrefixLength -lt 1 -or $networkPrefixLength -gt 32) {
|
||||||
|
throw "Public enrollment network '$Cidr' has an invalid prefix length."
|
||||||
|
}
|
||||||
|
if (Test-PrivateIPv4Address -Address $address) {
|
||||||
|
throw "Public enrollment network '$Cidr' is private RFC1918 space. Use -TrustedClientNetworks for LAN or VPN ranges."
|
||||||
|
}
|
||||||
|
$bytes = $address.GetAddressBytes()
|
||||||
|
if ($bytes[0] -in @(0, 127) -or
|
||||||
|
($bytes[0] -eq 169 -and $bytes[1] -eq 254) -or
|
||||||
|
$bytes[0] -ge 224) {
|
||||||
|
throw "Public enrollment network '$Cidr' is not usable unicast IPv4 space."
|
||||||
|
}
|
||||||
|
return ConvertTo-NetworkCidr -Address $address -NetworkPrefixLength $networkPrefixLength
|
||||||
|
}
|
||||||
|
|
||||||
|
function Set-SguPublicEnrollmentFirewall {
|
||||||
|
param(
|
||||||
|
[Parameter(Mandatory)][ipaddress]$LocalAddress,
|
||||||
|
[Parameter(Mandatory)][string[]]$RemoteAddress
|
||||||
|
)
|
||||||
|
|
||||||
|
if ($RemoteAddress.Count -eq 0) { return }
|
||||||
|
$definitions = @(
|
||||||
|
@{ Name = 'SGU Public Enrollment TCP'; Protocol = 'TCP';
|
||||||
|
Port = @('53','88','135','389','443','445','464','636','3268','3269','5985','8443','21115-21117','49152-65535') },
|
||||||
|
@{ Name = 'SGU Public Enrollment UDP'; Protocol = 'UDP';
|
||||||
|
Port = @('53','88','123','389','464','21116') }
|
||||||
|
)
|
||||||
|
foreach ($definition in $definitions) {
|
||||||
|
$rule = Get-NetFirewallRule -DisplayName $definition.Name -ErrorAction SilentlyContinue
|
||||||
|
if (-not $rule) {
|
||||||
|
New-NetFirewallRule -DisplayName $definition.Name -Direction Inbound -Action Allow `
|
||||||
|
-Protocol $definition.Protocol -LocalPort $definition.Port `
|
||||||
|
-LocalAddress $LocalAddress.IPAddressToString -RemoteAddress $RemoteAddress `
|
||||||
|
-Profile Any | Out-Null
|
||||||
|
}
|
||||||
|
else {
|
||||||
|
$rule | Set-NetFirewallRule -Enabled True -Action Allow -Profile Any | Out-Null
|
||||||
|
$rule | Get-NetFirewallPortFilter | Set-NetFirewallPortFilter `
|
||||||
|
-Protocol $definition.Protocol -LocalPort $definition.Port | Out-Null
|
||||||
|
$rule | Get-NetFirewallAddressFilter | Set-NetFirewallAddressFilter `
|
||||||
|
-LocalAddress $LocalAddress.IPAddressToString -RemoteAddress $RemoteAddress | Out-Null
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
function Get-ActiveIPv4Adapters {
|
||||||
|
# Accelerated Networking exposes an Up VF without an IP stack. Configure
|
||||||
|
# the synthetic adapter that owns IPv4, never the underlying VF.
|
||||||
|
Get-NetAdapter | Where-Object {
|
||||||
|
$_.Status -eq 'Up' -and
|
||||||
|
(Get-NetIPInterface -InterfaceIndex $_.ifIndex -AddressFamily IPv4 `
|
||||||
|
-ErrorAction SilentlyContinue | Where-Object ConnectionState -eq 'Connected')
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
function Resolve-PrivateInterfaceAlias {
|
function Resolve-PrivateInterfaceAlias {
|
||||||
param([string]$RequestedAlias)
|
param([string]$RequestedAlias)
|
||||||
|
|
||||||
@@ -76,7 +210,7 @@ function Resolve-PrivateInterfaceAlias {
|
|||||||
return $RequestedAlias
|
return $RequestedAlias
|
||||||
}
|
}
|
||||||
|
|
||||||
$upAdapters = @(Get-NetAdapter | Where-Object Status -eq 'Up')
|
$upAdapters = @(Get-ActiveIPv4Adapters)
|
||||||
$withoutGateway = @($upAdapters | Where-Object {
|
$withoutGateway = @($upAdapters | Where-Object {
|
||||||
-not (Get-NetIPConfiguration -InterfaceIndex $_.ifIndex).IPv4DefaultGateway
|
-not (Get-NetIPConfiguration -InterfaceIndex $_.ifIndex).IPv4DefaultGateway
|
||||||
})
|
})
|
||||||
@@ -146,6 +280,27 @@ function Set-StaticDomainAddress {
|
|||||||
-ServerAddresses $Address.IPAddressToString
|
-ServerAddresses $Address.IPAddressToString
|
||||||
}
|
}
|
||||||
|
|
||||||
|
function Assert-PlatformManagedDomainAddress {
|
||||||
|
param(
|
||||||
|
[Parameter(Mandatory)][string]$InterfaceAlias,
|
||||||
|
[Parameter(Mandatory)][ipaddress]$Address,
|
||||||
|
[Parameter(Mandatory)][int]$NetworkPrefixLength
|
||||||
|
)
|
||||||
|
|
||||||
|
$adapter = Get-NetAdapter -Name $InterfaceAlias -ErrorAction Stop
|
||||||
|
$matchingAddress = Get-NetIPAddress -InterfaceIndex $adapter.ifIndex -AddressFamily IPv4 `
|
||||||
|
-IPAddress $Address.IPAddressToString -ErrorAction SilentlyContinue |
|
||||||
|
Where-Object PrefixLength -eq $NetworkPrefixLength |
|
||||||
|
Select-Object -First 1
|
||||||
|
if (-not $matchingAddress) {
|
||||||
|
$observed = @(Get-NetIPAddress -InterfaceIndex $adapter.ifIndex -AddressFamily IPv4 `
|
||||||
|
-ErrorAction SilentlyContinue |
|
||||||
|
Where-Object PrefixOrigin -ne 'WellKnown' |
|
||||||
|
ForEach-Object { "$($_.IPAddress)/$($_.PrefixLength)" }) -join ', '
|
||||||
|
throw "PlatformManaged mode expected $Address/$NetworkPrefixLength on $InterfaceAlias, but found: $observed. Configure a static private IP on the Azure NIC before running the bootstrap; do not assign it inside Windows."
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
function Register-ResumeTask {
|
function Register-ResumeTask {
|
||||||
param([Parameter(Mandatory)][string]$ScriptPath)
|
param([Parameter(Mandatory)][string]$ScriptPath)
|
||||||
|
|
||||||
@@ -309,16 +464,33 @@ if ($Resume -or (-not $ServerIPv4Address -and $existingState)) {
|
|||||||
$PrefixLength = [int]$existingState.PrefixLength
|
$PrefixLength = [int]$existingState.PrefixLength
|
||||||
$NetworkInterfaceAlias = [string]$existingState.NetworkInterfaceAlias
|
$NetworkInterfaceAlias = [string]$existingState.NetworkInterfaceAlias
|
||||||
$DefaultGateway = if ($existingState.DefaultGateway) { [ipaddress][string]$existingState.DefaultGateway } else { $null }
|
$DefaultGateway = if ($existingState.DefaultGateway) { [ipaddress][string]$existingState.DefaultGateway } else { $null }
|
||||||
|
$NetworkConfigurationMode = if ($existingState.NetworkConfigurationMode) { [string]$existingState.NetworkConfigurationMode } else { 'GuestStatic' }
|
||||||
|
$TrustedClientNetworks = if ($existingState.TrustedClientNetworks) { @($existingState.TrustedClientNetworks | ForEach-Object { [string]$_ }) } else { @() }
|
||||||
|
$PublicEnrollmentNetworks = if ($existingState.PublicEnrollmentNetworks) { @($existingState.PublicEnrollmentNetworks | ForEach-Object { [string]$_ }) } else { @() }
|
||||||
$DnsForwarders = @($existingState.DnsForwarders | ForEach-Object { [ipaddress][string]$_ })
|
$DnsForwarders = @($existingState.DnsForwarders | ForEach-Object { [ipaddress][string]$_ })
|
||||||
$DomainName = [string]$existingState.DomainName
|
$DomainName = [string]$existingState.DomainName
|
||||||
$DomainNetbios = [string]$existingState.DomainNetbios
|
$DomainNetbios = [string]$existingState.DomainNetbios
|
||||||
$BrokerRecordName = [string]$existingState.BrokerRecordName
|
$BrokerRecordName = [string]$existingState.BrokerRecordName
|
||||||
|
$RustDeskRecordName = if ($existingState.RustDeskRecordName) { [string]$existingState.RustDeskRecordName } else { $RustDeskRecordName }
|
||||||
$PackageSharePath = [string]$existingState.PackageSharePath
|
$PackageSharePath = [string]$existingState.PackageSharePath
|
||||||
}
|
}
|
||||||
|
|
||||||
if (-not $ServerIPv4Address) {
|
if (-not $ServerIPv4Address) {
|
||||||
$ServerIPv4Address = [ipaddress](Read-Host 'Fixed IPv4 address for this domain controller')
|
$ServerIPv4Address = [ipaddress](Read-Host 'Fixed IPv4 address for this domain controller')
|
||||||
}
|
}
|
||||||
|
if (-not (Test-PrivateIPv4Address -Address $ServerIPv4Address)) {
|
||||||
|
throw 'ServerIPv4Address must be the private address of the domain controller. An Azure public IP is never assigned to AD or published in domain DNS.'
|
||||||
|
}
|
||||||
|
$domainSubnet = ConvertTo-NetworkCidr -Address $ServerIPv4Address `
|
||||||
|
-NetworkPrefixLength $PrefixLength
|
||||||
|
$TrustedClientNetworks = @($TrustedClientNetworks |
|
||||||
|
ForEach-Object { ConvertTo-PrivateNetworkCidr -Cidr $_ } |
|
||||||
|
Where-Object { $_ -ne $domainSubnet } |
|
||||||
|
Select-Object -Unique)
|
||||||
|
$PublicEnrollmentNetworks = @($PublicEnrollmentNetworks |
|
||||||
|
ForEach-Object { ConvertTo-PublicNetworkCidr -Cidr $_ } |
|
||||||
|
Select-Object -Unique)
|
||||||
|
$allowedRemoteAddresses = @($domainSubnet) + $TrustedClientNetworks + $PublicEnrollmentNetworks
|
||||||
|
|
||||||
$sourceRoot = $PSScriptRoot
|
$sourceRoot = $PSScriptRoot
|
||||||
if (-not $Resume) {
|
if (-not $Resume) {
|
||||||
@@ -336,6 +508,7 @@ else {
|
|||||||
$NetworkInterfaceAlias = Resolve-PrivateInterfaceAlias -RequestedAlias $NetworkInterfaceAlias
|
$NetworkInterfaceAlias = Resolve-PrivateInterfaceAlias -RequestedAlias $NetworkInterfaceAlias
|
||||||
$baseDn = Get-DomainBaseDn -DnsDomainName $DomainName
|
$baseDn = Get-DomainBaseDn -DnsDomainName $DomainName
|
||||||
$brokerDnsName = "$BrokerRecordName.$DomainName"
|
$brokerDnsName = "$BrokerRecordName.$DomainName"
|
||||||
|
$rustDeskDnsName = "$RustDeskRecordName.$DomainName"
|
||||||
$stagedScriptPath = Join-Path $bootstrapRoot 'Initialize-SguDomainController.ps1'
|
$stagedScriptPath = Join-Path $bootstrapRoot 'Initialize-SguDomainController.ps1'
|
||||||
$scriptsRoot = Join-Path $bootstrapRoot 'payload\scripts'
|
$scriptsRoot = Join-Path $bootstrapRoot 'payload\scripts'
|
||||||
$brokerPublishPath = Join-Path $bootstrapRoot 'payload\broker'
|
$brokerPublishPath = Join-Path $bootstrapRoot 'payload\broker'
|
||||||
@@ -345,9 +518,25 @@ foreach ($requiredPath in @(
|
|||||||
(Join-Path $scriptsRoot 'Deploy-AuthBroker.ps1'),
|
(Join-Path $scriptsRoot 'Deploy-AuthBroker.ps1'),
|
||||||
(Join-Path $scriptsRoot 'New-LabCertificate.ps1'),
|
(Join-Path $scriptsRoot 'New-LabCertificate.ps1'),
|
||||||
(Join-Path $scriptsRoot 'Set-LabBrokerDns.ps1'),
|
(Join-Path $scriptsRoot 'Set-LabBrokerDns.ps1'),
|
||||||
|
(Join-Path $scriptsRoot 'Set-SguInstitutionalPasswordPolicy.ps1'),
|
||||||
(Join-Path $scriptsRoot 'Set-SguDomainComputerPolicies.ps1'),
|
(Join-Path $scriptsRoot 'Set-SguDomainComputerPolicies.ps1'),
|
||||||
|
(Join-Path $scriptsRoot 'Enable-SguWorkstationRemoteAccess.ps1'),
|
||||||
|
(Join-Path $scriptsRoot 'Enable-SguWorkstationAdministrators.ps1'),
|
||||||
|
(Join-Path $scriptsRoot 'Install-SguWorkstationRemoteAccessPolicy.ps1'),
|
||||||
|
(Join-Path $scriptsRoot 'Install-SguDomainRemoteManagementPolicy.ps1'),
|
||||||
(Join-Path $scriptsRoot 'Set-SguDomainUserPolicies.ps1'),
|
(Join-Path $scriptsRoot 'Set-SguDomainUserPolicies.ps1'),
|
||||||
|
(Join-Path $scriptsRoot 'Set-SguLaboratorioWallpaperPolicy.ps1'),
|
||||||
(Join-Path $scriptsRoot 'Enable-SguServerRemoteManagement.ps1'),
|
(Join-Path $scriptsRoot 'Enable-SguServerRemoteManagement.ps1'),
|
||||||
|
(Join-Path $scriptsRoot 'Install-SguDomainMonitoring.ps1'),
|
||||||
|
(Join-Path $scriptsRoot 'Install-SguRustDeskClient.ps1'),
|
||||||
|
(Join-Path $scriptsRoot 'Install-SguRustDeskLinuxEnrollment.ps1'),
|
||||||
|
(Join-Path $scriptsRoot 'Install-SguRustDeskServer.ps1'),
|
||||||
|
(Join-Path $scriptsRoot 'Invoke-SguRustDeskLinuxRegistrationProcessor.ps1'),
|
||||||
|
(Join-Path $scriptsRoot 'Invoke-SguMonitoringMaintenance.ps1'),
|
||||||
|
(Join-Path $scriptsRoot 'Get-SguRustDeskDevice.ps1'),
|
||||||
|
(Join-Path $scriptsRoot 'Get-SguUsageReport.ps1'),
|
||||||
|
(Join-Path $scriptsRoot 'Get-SguBrokerLog.ps1'),
|
||||||
|
(Join-Path $scriptsRoot 'Register-SguRustDeskDevice.ps1'),
|
||||||
(Join-Path $brokerPublishPath 'SGU.AuthBroker.exe'))) {
|
(Join-Path $brokerPublishPath 'SGU.AuthBroker.exe'))) {
|
||||||
if (-not (Test-Path -LiteralPath $requiredPath -PathType Leaf)) {
|
if (-not (Test-Path -LiteralPath $requiredPath -PathType Leaf)) {
|
||||||
throw "The server bootstrap package is incomplete: $requiredPath"
|
throw "The server bootstrap package is incomplete: $requiredPath"
|
||||||
@@ -370,10 +559,14 @@ if (-not $existingState) {
|
|||||||
PrefixLength = $PrefixLength
|
PrefixLength = $PrefixLength
|
||||||
NetworkInterfaceAlias = $NetworkInterfaceAlias
|
NetworkInterfaceAlias = $NetworkInterfaceAlias
|
||||||
DefaultGateway = if ($DefaultGateway) { $DefaultGateway.IPAddressToString } else { $null }
|
DefaultGateway = if ($DefaultGateway) { $DefaultGateway.IPAddressToString } else { $null }
|
||||||
|
NetworkConfigurationMode = $NetworkConfigurationMode
|
||||||
|
TrustedClientNetworks = $TrustedClientNetworks
|
||||||
|
PublicEnrollmentNetworks = $PublicEnrollmentNetworks
|
||||||
DnsForwarders = @($DnsForwarders | ForEach-Object IPAddressToString)
|
DnsForwarders = @($DnsForwarders | ForEach-Object IPAddressToString)
|
||||||
DomainName = $DomainName
|
DomainName = $DomainName
|
||||||
DomainNetbios = $DomainNetbios
|
DomainNetbios = $DomainNetbios
|
||||||
BrokerRecordName = $BrokerRecordName
|
BrokerRecordName = $BrokerRecordName
|
||||||
|
RustDeskRecordName = $RustDeskRecordName
|
||||||
PackageSharePath = $PackageSharePath
|
PackageSharePath = $PackageSharePath
|
||||||
}
|
}
|
||||||
[IO.File]::WriteAllText(
|
[IO.File]::WriteAllText(
|
||||||
@@ -382,9 +575,16 @@ if (-not $existingState) {
|
|||||||
[Text.UTF8Encoding]::new($false))
|
[Text.UTF8Encoding]::new($false))
|
||||||
}
|
}
|
||||||
|
|
||||||
Write-BootstrapLog "Configuring $NetworkInterfaceAlias as $ServerIPv4Address/$PrefixLength."
|
if ($NetworkConfigurationMode -eq 'PlatformManaged') {
|
||||||
Set-StaticDomainAddress -InterfaceAlias $NetworkInterfaceAlias `
|
Write-BootstrapLog "Validating platform-managed address $ServerIPv4Address/$PrefixLength on $NetworkInterfaceAlias without changing DHCP, routes, or the Azure NIC."
|
||||||
-Address $ServerIPv4Address -NetworkPrefixLength $PrefixLength -Gateway $DefaultGateway
|
Assert-PlatformManagedDomainAddress -InterfaceAlias $NetworkInterfaceAlias `
|
||||||
|
-Address $ServerIPv4Address -NetworkPrefixLength $PrefixLength
|
||||||
|
}
|
||||||
|
else {
|
||||||
|
Write-BootstrapLog "Configuring $NetworkInterfaceAlias as $ServerIPv4Address/$PrefixLength."
|
||||||
|
Set-StaticDomainAddress -InterfaceAlias $NetworkInterfaceAlias `
|
||||||
|
-Address $ServerIPv4Address -NetworkPrefixLength $PrefixLength -Gateway $DefaultGateway
|
||||||
|
}
|
||||||
|
|
||||||
$computer = Get-CimInstance Win32_ComputerSystem
|
$computer = Get-CimInstance Win32_ComputerSystem
|
||||||
if (-not $computer.PartOfDomain) {
|
if (-not $computer.PartOfDomain) {
|
||||||
@@ -440,7 +640,7 @@ Write-BootstrapLog 'Finalizing Active Directory, DNS, policies, broker, shares,
|
|||||||
# Once the machine is a DC, every active adapter must query the local DNS
|
# Once the machine is a DC, every active adapter must query the local DNS
|
||||||
# service. Only the private domain adapter may publish its address in the AD
|
# service. Only the private domain adapter may publish its address in the AD
|
||||||
# zone; otherwise clients can receive the DHCP/NAT address of the Internet NIC.
|
# zone; otherwise clients can receive the DHCP/NAT address of the Internet NIC.
|
||||||
Get-NetAdapter | Where-Object Status -eq 'Up' | ForEach-Object {
|
Get-ActiveIPv4Adapters | ForEach-Object {
|
||||||
Set-DnsClientServerAddress -InterfaceIndex $_.ifIndex `
|
Set-DnsClientServerAddress -InterfaceIndex $_.ifIndex `
|
||||||
-ServerAddresses $ServerIPv4Address.IPAddressToString
|
-ServerAddresses $ServerIPv4Address.IPAddressToString
|
||||||
Set-DnsClient -InterfaceIndex $_.ifIndex `
|
Set-DnsClient -InterfaceIndex $_.ifIndex `
|
||||||
@@ -458,8 +658,17 @@ Wait-ActiveDirectoryReady -ExpectedBaseDn $baseDn
|
|||||||
$domainProfile = Get-NetConnectionProfile -InterfaceAlias $NetworkInterfaceAlias `
|
$domainProfile = Get-NetConnectionProfile -InterfaceAlias $NetworkInterfaceAlias `
|
||||||
-ErrorAction SilentlyContinue
|
-ErrorAction SilentlyContinue
|
||||||
if (-not $domainProfile -or $domainProfile.NetworkCategory -ne 'DomainAuthenticated') {
|
if (-not $domainProfile -or $domainProfile.NetworkCategory -ne 'DomainAuthenticated') {
|
||||||
Write-BootstrapLog "Refreshing $NetworkInterfaceAlias so Windows detects the domain network profile."
|
if ($NetworkConfigurationMode -eq 'GuestStatic') {
|
||||||
Restart-NetAdapter -Name $NetworkInterfaceAlias -Confirm:$false
|
Write-BootstrapLog "Refreshing $NetworkInterfaceAlias so Windows detects the domain network profile."
|
||||||
|
Restart-NetAdapter -Name $NetworkInterfaceAlias -Confirm:$false
|
||||||
|
}
|
||||||
|
else {
|
||||||
|
# Restarting an Azure NIC from inside the guest can sever the only
|
||||||
|
# management path. Refresh NLA instead; this does not change the
|
||||||
|
# platform-managed address, DHCP lease, route, or link state.
|
||||||
|
Write-BootstrapLog 'Refreshing Network Location Awareness without restarting the Azure adapter.'
|
||||||
|
Restart-Service NlaSvc -Force -ErrorAction SilentlyContinue
|
||||||
|
}
|
||||||
for ($attempt = 1; $attempt -le 15; $attempt++) {
|
for ($attempt = 1; $attempt -le 15; $attempt++) {
|
||||||
Start-Sleep -Seconds 2
|
Start-Sleep -Seconds 2
|
||||||
$domainProfile = Get-NetConnectionProfile -InterfaceAlias $NetworkInterfaceAlias `
|
$domainProfile = Get-NetConnectionProfile -InterfaceAlias $NetworkInterfaceAlias `
|
||||||
@@ -512,6 +721,10 @@ if (-not $remoteDesktopGroup) {
|
|||||||
-RecordName $BrokerRecordName `
|
-RecordName $BrokerRecordName `
|
||||||
-IPv4Address $ServerIPv4Address `
|
-IPv4Address $ServerIPv4Address `
|
||||||
-ExternalForwarders $DnsForwarders | Out-Null
|
-ExternalForwarders $DnsForwarders | Out-Null
|
||||||
|
& (Join-Path $scriptsRoot 'Set-LabBrokerDns.ps1') `
|
||||||
|
-ZoneName $DomainName `
|
||||||
|
-RecordName $RustDeskRecordName `
|
||||||
|
-IPv4Address $ServerIPv4Address | Out-Null
|
||||||
|
|
||||||
$certificateDirectory = Join-Path $bootstrapRoot 'certificates'
|
$certificateDirectory = Join-Path $bootstrapRoot 'certificates'
|
||||||
$serverCertificate = Get-ChildItem Cert:\LocalMachine\My |
|
$serverCertificate = Get-ChildItem Cert:\LocalMachine\My |
|
||||||
@@ -559,10 +772,13 @@ if (Test-Path -LiteralPath $brokerConfigurationPath -PathType Leaf) {
|
|||||||
-RemoteDesktopGroupDn $remoteDesktopGroup.DistinguishedName `
|
-RemoteDesktopGroupDn $remoteDesktopGroup.DistinguishedName `
|
||||||
-DefaultCompany 'La Salle' `
|
-DefaultCompany 'La Salle' `
|
||||||
-FirewallLocalAddress $ServerIPv4Address `
|
-FirewallLocalAddress $ServerIPv4Address `
|
||||||
-FirewallRemoteAddress "$($ServerIPv4Address.IPAddressToString)/$PrefixLength" `
|
-FirewallRemoteAddress $allowedRemoteAddresses `
|
||||||
-CreateMissingOus `
|
-CreateMissingOus `
|
||||||
-DisableCertificateRevocationCheckForLab | Out-Null
|
-DisableCertificateRevocationCheckForLab | Out-Null
|
||||||
|
|
||||||
|
& (Join-Path $scriptsRoot 'Set-SguInstitutionalPasswordPolicy.ps1') `
|
||||||
|
-BaseDn $baseDn -DomainController $adServer | Out-Null
|
||||||
|
|
||||||
# Remove stale A records registered by any non-domain/NAT adapter before its
|
# Remove stale A records registered by any non-domain/NAT adapter before its
|
||||||
# dynamic DNS registration was disabled.
|
# dynamic DNS registration was disabled.
|
||||||
$hostRecords = @(Get-DnsServerResourceRecord -ZoneName $DomainName `
|
$hostRecords = @(Get-DnsServerResourceRecord -ZoneName $DomainName `
|
||||||
@@ -573,9 +789,10 @@ foreach ($hostRecord in $hostRecords) {
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
$privateSubnet = "$($ServerIPv4Address.IPAddressToString)/$PrefixLength"
|
|
||||||
& (Join-Path $scriptsRoot 'Enable-SguServerRemoteManagement.ps1') `
|
& (Join-Path $scriptsRoot 'Enable-SguServerRemoteManagement.ps1') `
|
||||||
-AllowedRemoteAddress $privateSubnet | Out-Null
|
-AllowedRemoteAddress $allowedRemoteAddresses | Out-Null
|
||||||
|
Set-SguPublicEnrollmentFirewall -LocalAddress $ServerIPv4Address `
|
||||||
|
-RemoteAddress $PublicEnrollmentNetworks
|
||||||
|
|
||||||
$contentPath = Join-Path $bootstrapRoot 'payload\server-content\Packages'
|
$contentPath = Join-Path $bootstrapRoot 'payload\server-content\Packages'
|
||||||
if (Test-Path -LiteralPath $contentPath -PathType Container) {
|
if (Test-Path -LiteralPath $contentPath -PathType Container) {
|
||||||
@@ -595,7 +812,7 @@ if (-not $packageFirewallRule) {
|
|||||||
-Protocol TCP `
|
-Protocol TCP `
|
||||||
-LocalPort 445 `
|
-LocalPort 445 `
|
||||||
-LocalAddress $ServerIPv4Address.IPAddressToString `
|
-LocalAddress $ServerIPv4Address.IPAddressToString `
|
||||||
-RemoteAddress $privateSubnet `
|
-RemoteAddress $allowedRemoteAddresses `
|
||||||
-Profile Any | Out-Null
|
-Profile Any | Out-Null
|
||||||
}
|
}
|
||||||
else {
|
else {
|
||||||
@@ -603,35 +820,93 @@ else {
|
|||||||
$packageFirewallRule | Get-NetFirewallAddressFilter |
|
$packageFirewallRule | Get-NetFirewallAddressFilter |
|
||||||
Set-NetFirewallAddressFilter `
|
Set-NetFirewallAddressFilter `
|
||||||
-LocalAddress $ServerIPv4Address.IPAddressToString `
|
-LocalAddress $ServerIPv4Address.IPAddressToString `
|
||||||
-RemoteAddress $privateSubnet | Out-Null
|
-RemoteAddress $allowedRemoteAddresses | Out-Null
|
||||||
}
|
}
|
||||||
|
|
||||||
|
$collectorFqdn = "$env:COMPUTERNAME.$DomainName"
|
||||||
& (Join-Path $scriptsRoot 'Set-SguDomainComputerPolicies.ps1') `
|
& (Join-Path $scriptsRoot 'Set-SguDomainComputerPolicies.ps1') `
|
||||||
-TargetOuDn $laboratoryOuDn -DomainController $env:COMPUTERNAME | Out-Null
|
-TargetOuDn $laboratoryOuDn `
|
||||||
|
-DomainController $env:COMPUTERNAME `
|
||||||
|
-EventCollectorFqdn $collectorFqdn | Out-Null
|
||||||
|
|
||||||
|
& (Join-Path $scriptsRoot 'Install-SguWorkstationRemoteAccessPolicy.ps1') `
|
||||||
|
-TargetOuDn $laboratoryOuDn `
|
||||||
|
-DomainController $env:COMPUTERNAME | Out-Null
|
||||||
|
& (Join-Path $scriptsRoot 'Install-SguDomainRemoteManagementPolicy.ps1') `
|
||||||
|
-DomainController $env:COMPUTERNAME | Out-Null
|
||||||
|
& (Join-Path $scriptsRoot 'Install-SguDomainMonitoring.ps1') `
|
||||||
|
-CollectorFqdn $collectorFqdn `
|
||||||
|
-ComputerOuDn $laboratoryOuDn `
|
||||||
|
-RetentionDays 183 | Out-Null
|
||||||
$userPolicyParameters = @{
|
$userPolicyParameters = @{
|
||||||
TargetOuDn = $usersOuDn
|
TargetOuDn = $usersOuDn
|
||||||
DomainController = $env:COMPUTERNAME
|
DomainController = $env:COMPUTERNAME
|
||||||
}
|
ClearManagedWallpaper = $true
|
||||||
$wallpaper = Get-ChildItem -LiteralPath $PackageSharePath -File -ErrorAction SilentlyContinue |
|
|
||||||
Where-Object { $_.BaseName -eq 'wallpaper' -and $_.Extension -in @('.jpg','.jpeg','.png','.bmp') } |
|
|
||||||
Sort-Object Name |
|
|
||||||
Select-Object -First 1
|
|
||||||
if ($wallpaper) {
|
|
||||||
$userPolicyParameters.WallpaperPath = "\\$env:COMPUTERNAME\Packages\$($wallpaper.Name)"
|
|
||||||
}
|
}
|
||||||
& (Join-Path $scriptsRoot 'Set-SguDomainUserPolicies.ps1') @userPolicyParameters | Out-Null
|
& (Join-Path $scriptsRoot 'Set-SguDomainUserPolicies.ps1') @userPolicyParameters | Out-Null
|
||||||
|
& (Join-Path $scriptsRoot 'Set-SguLaboratorioWallpaperPolicy.ps1') `
|
||||||
|
-TargetOuDn $laboratoryOuDn -DomainController $env:COMPUTERNAME | Out-Null
|
||||||
|
|
||||||
|
$rustDeskServer = & (Join-Path $scriptsRoot 'Install-SguRustDeskServer.ps1') `
|
||||||
|
-ServerAddress $rustDeskDnsName `
|
||||||
|
-FirewallRemoteAddress $allowedRemoteAddresses
|
||||||
|
$rustDeskManagementRoot = Join-Path $env:ProgramData 'SGU\RustDesk'
|
||||||
|
New-Item -ItemType Directory -Path $rustDeskManagementRoot -Force | Out-Null
|
||||||
|
foreach ($scriptName in @(
|
||||||
|
'Register-SguRustDeskDevice.ps1',
|
||||||
|
'Get-SguRustDeskDevice.ps1',
|
||||||
|
'Install-SguRustDeskLinuxEnrollment.ps1',
|
||||||
|
'Invoke-SguRustDeskLinuxRegistrationProcessor.ps1')) {
|
||||||
|
Copy-Item -LiteralPath (Join-Path $scriptsRoot $scriptName) `
|
||||||
|
-Destination (Join-Path $rustDeskManagementRoot $scriptName) -Force
|
||||||
|
}
|
||||||
|
$rustDeskLinuxEnrollment = & (Join-Path $rustDeskManagementRoot 'Install-SguRustDeskLinuxEnrollment.ps1') `
|
||||||
|
-DomainName $DomainName `
|
||||||
|
-ServerAddress $rustDeskDnsName `
|
||||||
|
-ServerPublicKey $rustDeskServer.PublicKey `
|
||||||
|
-ProcessorScriptPath (Join-Path $rustDeskManagementRoot 'Invoke-SguRustDeskLinuxRegistrationProcessor.ps1')
|
||||||
|
$rustDeskServerClient = & (Join-Path $scriptsRoot 'Install-SguRustDeskClient.ps1') `
|
||||||
|
-ServerAddress $rustDeskDnsName `
|
||||||
|
-ServerPublicKey $rustDeskServer.PublicKey
|
||||||
|
$rustDeskPasswordPointer = [Runtime.InteropServices.Marshal]::SecureStringToBSTR(
|
||||||
|
$rustDeskServerClient.AccessPassword)
|
||||||
|
try {
|
||||||
|
$rustDeskPassword = [Runtime.InteropServices.Marshal]::PtrToStringBSTR($rustDeskPasswordPointer)
|
||||||
|
& (Join-Path $rustDeskManagementRoot 'Register-SguRustDeskDevice.ps1') `
|
||||||
|
-ComputerName $env:COMPUTERNAME `
|
||||||
|
-RustDeskId $rustDeskServerClient.RustDeskId `
|
||||||
|
-AccessPassword $rustDeskPassword | Out-Null
|
||||||
|
}
|
||||||
|
finally {
|
||||||
|
[Runtime.InteropServices.Marshal]::ZeroFreeBSTR($rustDeskPasswordPointer)
|
||||||
|
$rustDeskPassword = $null
|
||||||
|
}
|
||||||
|
|
||||||
$validation = [ordered]@{
|
$validation = [ordered]@{
|
||||||
CompletedAt = (Get-Date).ToString('o')
|
CompletedAt = (Get-Date).ToString('o')
|
||||||
ComputerName = $env:COMPUTERNAME
|
ComputerName = $env:COMPUTERNAME
|
||||||
DomainName = $DomainName
|
DomainName = $DomainName
|
||||||
ServerIPv4Address = $ServerIPv4Address.IPAddressToString
|
ServerIPv4Address = $ServerIPv4Address.IPAddressToString
|
||||||
|
NetworkConfigurationMode = $NetworkConfigurationMode
|
||||||
|
TrustedClientNetworks = $TrustedClientNetworks
|
||||||
|
PublicEnrollmentNetworks = $PublicEnrollmentNetworks
|
||||||
|
AllowedRemoteAddresses = $allowedRemoteAddresses
|
||||||
BrokerDnsName = $brokerDnsName
|
BrokerDnsName = $brokerDnsName
|
||||||
BrokerCertificateThumbprint = $serverCertificate.Thumbprint
|
BrokerCertificateThumbprint = $serverCertificate.Thumbprint
|
||||||
BrokerService = (Get-Service SGUAuthBroker).Status.ToString()
|
BrokerService = (Get-Service SGUAuthBroker).Status.ToString()
|
||||||
BrokerPortListening = [bool](Get-NetTCPConnection -LocalPort 8443 -State Listen -ErrorAction SilentlyContinue)
|
BrokerPortListening = [bool](Get-NetTCPConnection -LocalPort 8443 -State Listen -ErrorAction SilentlyContinue)
|
||||||
WinRM = (Get-Service WinRM).Status.ToString()
|
WinRM = (Get-Service WinRM).Status.ToString()
|
||||||
RemoteDesktop = (Get-Service TermService).Status.ToString()
|
RemoteDesktop = (Get-Service TermService).Status.ToString()
|
||||||
|
RustDeskServerAddress = $rustDeskServer.ServerAddress
|
||||||
|
RustDeskHbbsTask = $rustDeskServer.HbbsTask
|
||||||
|
RustDeskHbbrTask = $rustDeskServer.HbbrTask
|
||||||
|
RustDeskHbbsListening = $rustDeskServer.HbbsListening
|
||||||
|
RustDeskHbbrListening = $rustDeskServer.HbbrListening
|
||||||
|
RustDeskLinuxRegistrationTask = (Get-ScheduledTask -TaskName $rustDeskLinuxEnrollment.RegistrationTask).State.ToString()
|
||||||
|
RustDeskServerClientId = $rustDeskServerClient.RustDeskId
|
||||||
|
EventCollector = (Get-Service Wecsvc).Status.ToString()
|
||||||
|
EventSubscription = @(& wecutil.exe enum-subscription) -contains 'SGU-Lab-Monitoring'
|
||||||
|
MonitoringRetentionDays = 183
|
||||||
PackageShare = "\\$env:COMPUTERNAME\Packages"
|
PackageShare = "\\$env:COMPUTERNAME\Packages"
|
||||||
LaboratoryOu = $laboratoryOuDn
|
LaboratoryOu = $laboratoryOuDn
|
||||||
UsersOu = $usersOuDn
|
UsersOu = $usersOuDn
|
||||||
@@ -643,7 +918,15 @@ $validation = [ordered]@{
|
|||||||
if ($validation.BrokerService -ne 'Running' -or
|
if ($validation.BrokerService -ne 'Running' -or
|
||||||
-not $validation.BrokerPortListening -or
|
-not $validation.BrokerPortListening -or
|
||||||
$validation.WinRM -ne 'Running' -or
|
$validation.WinRM -ne 'Running' -or
|
||||||
$validation.RemoteDesktop -ne 'Running') {
|
$validation.RemoteDesktop -ne 'Running' -or
|
||||||
|
$validation.RustDeskHbbsTask -ne 'Running' -or
|
||||||
|
$validation.RustDeskHbbrTask -ne 'Running' -or
|
||||||
|
$validation.RustDeskLinuxRegistrationTask -notin @('Ready', 'Running') -or
|
||||||
|
-not $validation.RustDeskHbbsListening -or
|
||||||
|
-not $validation.RustDeskHbbrListening -or
|
||||||
|
$validation.EventCollector -ne 'Running' -or
|
||||||
|
-not $validation.EventSubscription -or
|
||||||
|
$validation.DomainNetworkProfile -ne 'DomainAuthenticated') {
|
||||||
throw 'Server finalization did not pass service validation. Review bootstrap.log and re-run the bootstrap.'
|
throw 'Server finalization did not pass service validation. Review bootstrap.log and re-run the bootstrap.'
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|||||||
@@ -37,6 +37,13 @@ $defaultProviderPolicyPath = 'HKLM:\SOFTWARE\Policies\Microsoft\Windows\System'
|
|||||||
$interactiveLogonPolicyPath = 'HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\Policies\System'
|
$interactiveLogonPolicyPath = 'HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\Policies\System'
|
||||||
$accountPictureSourcePath = Join-Path $PublishPath 'branding\user.png'
|
$accountPictureSourcePath = Join-Path $PublishPath 'branding\user.png'
|
||||||
$accountPictureDirectory = Join-Path $env:ProgramData 'Microsoft\User Account Pictures'
|
$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'
|
||||||
|
$welcomeWallpaperDirectory = Join-Path $env:ProgramData 'SGU\Branding'
|
||||||
|
|
||||||
$identity = [Security.Principal.WindowsIdentity]::GetCurrent()
|
$identity = [Security.Principal.WindowsIdentity]::GetCurrent()
|
||||||
$principal = [Security.Principal.WindowsPrincipal]::new($identity)
|
$principal = [Security.Principal.WindowsPrincipal]::new($identity)
|
||||||
@@ -122,6 +129,34 @@ function Install-DefaultAccountPicture {
|
|||||||
return $true
|
return $true
|
||||||
}
|
}
|
||||||
|
|
||||||
|
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
|
||||||
|
}
|
||||||
|
|
||||||
|
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 `
|
||||||
|
-Destination (Join-Path $welcomeWallpaperDirectory 'Set-SguWelcomeWallpaper.ps1') -Force
|
||||||
|
if (Test-Path -LiteralPath $welcomeFontsSourcePath -PathType Container) {
|
||||||
|
$fontDestination = Join-Path $welcomeWallpaperDirectory 'fonts'
|
||||||
|
New-Item -ItemType Directory -Path $fontDestination -Force | Out-Null
|
||||||
|
Copy-Item -Path (Join-Path $welcomeFontsSourcePath '*') -Destination $fontDestination -Force
|
||||||
|
}
|
||||||
|
return $true
|
||||||
|
}
|
||||||
|
|
||||||
if (-not (Test-DotNet10Runtime)) {
|
if (-not (Test-DotNet10Runtime)) {
|
||||||
if (-not $InstallDotNetRuntime) {
|
if (-not $InstallDotNetRuntime) {
|
||||||
throw 'Microsoft .NET 10 x64 runtime is required. Re-run with -InstallDotNetRuntime or install it first.'
|
throw 'Microsoft .NET 10 x64 runtime is required. Re-run with -InstallDotNetRuntime or install it first.'
|
||||||
@@ -235,6 +270,7 @@ if ($PSCmdlet.ShouldProcess($installPath, 'Install and register the SGU Credenti
|
|||||||
# The domain GPO selects the Windows default account picture. Install its
|
# The domain GPO selects the Windows default account picture. Install its
|
||||||
# branded bitmap during enrollment so no per-machine manual setup is needed.
|
# branded bitmap during enrollment so no per-machine manual setup is needed.
|
||||||
Install-DefaultAccountPicture -SourcePath $accountPictureSourcePath | Out-Null
|
Install-DefaultAccountPicture -SourcePath $accountPictureSourcePath | Out-Null
|
||||||
|
Install-WelcomeWallpaperAssets | Out-Null
|
||||||
|
|
||||||
New-Item -ItemType Directory -Path (Split-Path $settingsPath -Parent) -Force | Out-Null
|
New-Item -ItemType Directory -Path (Split-Path $settingsPath -Parent) -Force | Out-Null
|
||||||
$settingsJson = @{
|
$settingsJson = @{
|
||||||
@@ -264,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-ItemProperty -Path $classRegistryPath -Name ThreadingModel -Value Both -PropertyType String -Force | Out-Null
|
||||||
|
|
||||||
New-Item -Path $providerRegistryPath -Force | Out-Null
|
New-Item -Path $providerRegistryPath -Force | Out-Null
|
||||||
# Windows PowerShell 5.1 interprets an UTF-8 script without a BOM using the
|
Set-Item -Path $providerRegistryPath -Value 'Acceso Institucional'
|
||||||
# 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)
|
|
||||||
|
|
||||||
if (-not $DoNotSetAsDefaultCredentialProvider) {
|
if (-not $DoNotSetAsDefaultCredentialProvider) {
|
||||||
if (-not (Test-Path -LiteralPath $defaultProviderPolicyPath)) {
|
if (-not (Test-Path -LiteralPath $defaultProviderPolicyPath)) {
|
||||||
@@ -280,7 +313,7 @@ if ($PSCmdlet.ShouldProcess($installPath, 'Install and register the SGU Credenti
|
|||||||
-Force | Out-Null
|
-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.
|
# The Microsoft password provider remains registered and supplies Other user.
|
||||||
if (-not (Test-Path -LiteralPath $interactiveLogonPolicyPath)) {
|
if (-not (Test-Path -LiteralPath $interactiveLogonPolicyPath)) {
|
||||||
New-Item -Path $interactiveLogonPolicyPath -Force | Out-Null
|
New-Item -Path $interactiveLogonPolicyPath -Force | Out-Null
|
||||||
@@ -290,6 +323,11 @@ if ($PSCmdlet.ShouldProcess($installPath, 'Install and register the SGU Credenti
|
|||||||
-Value 1 `
|
-Value 1 `
|
||||||
-PropertyType DWord `
|
-PropertyType DWord `
|
||||||
-Force | Out-Null
|
-Force | Out-Null
|
||||||
|
New-ItemProperty -Path $interactiveLogonPolicyPath `
|
||||||
|
-Name HideFastUserSwitching `
|
||||||
|
-Value 1 `
|
||||||
|
-PropertyType DWord `
|
||||||
|
-Force | Out-Null
|
||||||
if (-not (Test-Path -LiteralPath $defaultProviderPolicyPath)) {
|
if (-not (Test-Path -LiteralPath $defaultProviderPolicyPath)) {
|
||||||
New-Item -Path $defaultProviderPolicyPath -Force | Out-Null
|
New-Item -Path $defaultProviderPolicyPath -Force | Out-Null
|
||||||
}
|
}
|
||||||
@@ -320,8 +358,17 @@ catch {
|
|||||||
LastSignedInUserHidden = (Get-ItemPropertyValue `
|
LastSignedInUserHidden = (Get-ItemPropertyValue `
|
||||||
-LiteralPath $interactiveLogonPolicyPath `
|
-LiteralPath $interactiveLogonPolicyPath `
|
||||||
-Name DontDisplayLastUserName) -eq 1
|
-Name DontDisplayLastUserName) -eq 1
|
||||||
|
FastUserSwitchingHidden = (Get-ItemPropertyValue `
|
||||||
|
-LiteralPath $interactiveLogonPolicyPath `
|
||||||
|
-Name HideFastUserSwitching) -eq 1
|
||||||
LocalUserEnumerationDisabled = (Get-ItemPropertyValue `
|
LocalUserEnumerationDisabled = (Get-ItemPropertyValue `
|
||||||
-LiteralPath $defaultProviderPolicyPath `
|
-LiteralPath $defaultProviderPolicyPath `
|
||||||
-Name EnumerateLocalUsers) -eq 0
|
-Name EnumerateLocalUsers) -eq 0
|
||||||
SystemPasswordProviderPreserved = $true
|
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,127 @@
|
|||||||
|
#Requires -Version 5.1
|
||||||
|
#Requires -RunAsAdministrator
|
||||||
|
[CmdletBinding(SupportsShouldProcess)]
|
||||||
|
param(
|
||||||
|
[Parameter(Mandatory)][string]$VpnProfilePackagePath,
|
||||||
|
[Parameter(Mandatory)][string]$ClientCertificatePfxPath,
|
||||||
|
[securestring]$ClientCertificatePfxPassword,
|
||||||
|
[Parameter(Mandatory)][string]$ClientRootCertificatePath,
|
||||||
|
[string]$ConnectionName = 'SGU Azure P2S',
|
||||||
|
[string[]]$AzureNetworkPrefixes = @('10.77.0.0/16'),
|
||||||
|
[ipaddress]$DomainControllerIPv4Address = '10.77.0.4',
|
||||||
|
[string]$DomainName = 'lci.lasalle.mx',
|
||||||
|
[switch]$Connect
|
||||||
|
)
|
||||||
|
|
||||||
|
$ErrorActionPreference = 'Stop'
|
||||||
|
foreach ($path in @($VpnProfilePackagePath,$ClientCertificatePfxPath,$ClientRootCertificatePath)) {
|
||||||
|
if (-not (Test-Path -LiteralPath $path -PathType Leaf)) {
|
||||||
|
throw "Required P2S file not found: $path"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
if (-not $ClientCertificatePfxPassword) {
|
||||||
|
$ClientCertificatePfxPassword = Read-Host 'Password protecting the P2S client PFX' -AsSecureString
|
||||||
|
}
|
||||||
|
|
||||||
|
$temporaryRoot = Join-Path $env:ProgramData ("SGU\AzureP2S\Import-" + [Guid]::NewGuid().ToString('N'))
|
||||||
|
try {
|
||||||
|
Expand-Archive -LiteralPath $VpnProfilePackagePath -DestinationPath $temporaryRoot -Force
|
||||||
|
$vpnSettingsPath = Get-ChildItem -LiteralPath $temporaryRoot -Recurse -Filter VpnSettings.xml -File |
|
||||||
|
Select-Object -First 1 -ExpandProperty FullName
|
||||||
|
if (-not $vpnSettingsPath) {
|
||||||
|
throw 'The Azure package does not contain Generic\VpnSettings.xml. Generate it with IKEv2 enabled.'
|
||||||
|
}
|
||||||
|
[xml]$vpnSettings = Get-Content -LiteralPath $vpnSettingsPath -Raw
|
||||||
|
$vpnServerNode = $vpnSettings.SelectSingleNode('//*[local-name()="VpnServer"]')
|
||||||
|
if (-not $vpnServerNode -or [string]::IsNullOrWhiteSpace($vpnServerNode.InnerText)) {
|
||||||
|
throw 'VpnSettings.xml does not contain the Azure VPN gateway FQDN.'
|
||||||
|
}
|
||||||
|
$vpnServer = $vpnServerNode.InnerText.Trim()
|
||||||
|
|
||||||
|
$serverRootPath = Get-ChildItem -LiteralPath (Split-Path $vpnSettingsPath -Parent) `
|
||||||
|
-Filter VpnServerRoot.cer -File | Select-Object -First 1 -ExpandProperty FullName
|
||||||
|
if ($serverRootPath) {
|
||||||
|
Import-Certificate -FilePath $serverRootPath -CertStoreLocation Cert:\LocalMachine\Root | Out-Null
|
||||||
|
}
|
||||||
|
$clientRoot = Import-Certificate -FilePath $ClientRootCertificatePath `
|
||||||
|
-CertStoreLocation Cert:\LocalMachine\Root | Select-Object -First 1
|
||||||
|
$clientCertificates = @(Import-PfxCertificate -FilePath $ClientCertificatePfxPath `
|
||||||
|
-Password $ClientCertificatePfxPassword -CertStoreLocation Cert:\LocalMachine\My)
|
||||||
|
$clientCertificate = $clientCertificates |
|
||||||
|
Where-Object {
|
||||||
|
$_.HasPrivateKey -and
|
||||||
|
$_.NotAfter -gt (Get-Date) -and
|
||||||
|
@($_.EnhancedKeyUsageList | ForEach-Object ObjectId) -contains '1.3.6.1.5.5.7.3.2'
|
||||||
|
} |
|
||||||
|
Sort-Object NotAfter -Descending |
|
||||||
|
Select-Object -First 1
|
||||||
|
if (-not $clientCertificate) {
|
||||||
|
throw 'The imported PFX does not contain a valid Client Authentication certificate with a private key.'
|
||||||
|
}
|
||||||
|
|
||||||
|
if ($PSCmdlet.ShouldProcess($ConnectionName, 'Install an all-user IKEv2 Azure P2S connection using a machine certificate')) {
|
||||||
|
$existingConnection = Get-VpnConnection -Name $ConnectionName -AllUserConnection `
|
||||||
|
-ErrorAction SilentlyContinue
|
||||||
|
if ($existingConnection) {
|
||||||
|
Remove-VpnConnection -Name $ConnectionName -AllUserConnection -Force
|
||||||
|
}
|
||||||
|
$dnsParameters = @{}
|
||||||
|
if ($DomainName) { $dnsParameters.DnsSuffix = $DomainName }
|
||||||
|
Add-VpnConnection @dnsParameters `
|
||||||
|
-Name $ConnectionName `
|
||||||
|
-ServerAddress $vpnServer `
|
||||||
|
-TunnelType Ikev2 `
|
||||||
|
-AuthenticationMethod MachineCertificate `
|
||||||
|
-MachineCertificateIssuerFilter $clientRoot `
|
||||||
|
-MachineCertificateEKUFilter '1.3.6.1.5.5.7.3.2' `
|
||||||
|
-EncryptionLevel Required `
|
||||||
|
-SplitTunneling `
|
||||||
|
-AllUserConnection `
|
||||||
|
-Force | Out-Null
|
||||||
|
foreach ($prefix in $AzureNetworkPrefixes) {
|
||||||
|
Add-VpnConnectionRoute -ConnectionName $ConnectionName `
|
||||||
|
-DestinationPrefix $prefix -AllUserConnection -PassThru | Out-Null
|
||||||
|
}
|
||||||
|
|
||||||
|
# The unified bootstrap can discover the domain after connecting.
|
||||||
|
if ($DomainName) {
|
||||||
|
$nrptDisplayName = "SGU Azure P2S DNS - $DomainName"
|
||||||
|
Get-DnsClientNrptRule -ErrorAction SilentlyContinue |
|
||||||
|
Where-Object DisplayName -eq $nrptDisplayName |
|
||||||
|
Remove-DnsClientNrptRule -Force
|
||||||
|
Add-DnsClientNrptRule `
|
||||||
|
-Namespace ".$DomainName" `
|
||||||
|
-NameServers $DomainControllerIPv4Address.IPAddressToString `
|
||||||
|
-DisplayName $nrptDisplayName `
|
||||||
|
-Comment 'Managed by SGU Azure P2S bootstrap; routes only the AD namespace to the domain controller.' | Out-Null
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
if ($Connect) {
|
||||||
|
& "$env:SystemRoot\System32\rasdial.exe" $ConnectionName
|
||||||
|
if ($LASTEXITCODE -ne 0) {
|
||||||
|
throw "Windows could not connect $ConnectionName. Verify UDP 500/4500 (IKEv2), or configure the Azure-generated OpenVPN profile in Azure VPN Client when the local network blocks IKEv2."
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
$connection = Get-VpnConnection -Name $ConnectionName -AllUserConnection
|
||||||
|
[pscustomobject]@{
|
||||||
|
ConnectionName = $connection.Name
|
||||||
|
ServerAddress = $connection.ServerAddress
|
||||||
|
TunnelType = $connection.TunnelType
|
||||||
|
AllUserConnection = $true
|
||||||
|
AuthenticationMethod = $connection.AuthenticationMethod
|
||||||
|
ConnectionStatus = $connection.ConnectionStatus
|
||||||
|
ClientCertificateThumbprint = $clientCertificate.Thumbprint
|
||||||
|
DomainControllerIPv4Address = $DomainControllerIPv4Address.IPAddressToString
|
||||||
|
DomainDnsNamespace = ".$DomainName"
|
||||||
|
AzureNetworkPrefixes = $AzureNetworkPrefixes
|
||||||
|
AvailableBeforeLogon = $true
|
||||||
|
}
|
||||||
|
}
|
||||||
|
finally {
|
||||||
|
$ClientCertificatePfxPassword = $null
|
||||||
|
if (Test-Path -LiteralPath $temporaryRoot) {
|
||||||
|
Remove-Item -LiteralPath $temporaryRoot -Recurse -Force -ErrorAction SilentlyContinue
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,78 @@
|
|||||||
|
[CmdletBinding()]
|
||||||
|
param()
|
||||||
|
$ErrorActionPreference = 'Stop'
|
||||||
|
# Native WLAN AutoConfig holds the machine profile before interactive logon.
|
||||||
|
$computer=Get-CimInstance Win32_ComputerSystem
|
||||||
|
if(-not $computer.PartOfDomain -or $computer.DomainRole -ne 1 -or $env:COMPUTERNAME -notmatch '^(AF|SD|SI)-'){return}
|
||||||
|
$destination = 'C:\ProgramData\LCI-Admin\CED-WiFi'
|
||||||
|
New-Item $destination -ItemType Directory -Force | Out-Null
|
||||||
|
$acl = [Security.AccessControl.DirectorySecurity]::new()
|
||||||
|
$acl.SetAccessRuleProtection($true,$false)
|
||||||
|
foreach ($sid in 'S-1-5-18','S-1-5-32-544') {
|
||||||
|
$acl.AddAccessRule([Security.AccessControl.FileSystemAccessRule]::new(
|
||||||
|
[Security.Principal.SecurityIdentifier]::new($sid),'FullControl','ContainerInherit,ObjectInherit','None','Allow'))
|
||||||
|
}
|
||||||
|
if((Get-Acl -LiteralPath $destination).GetSecurityDescriptorSddlForm([Security.AccessControl.AccessControlSections]::Access) -ne $acl.GetSecurityDescriptorSddlForm([Security.AccessControl.AccessControlSections]::Access)){Set-Acl -LiteralPath $destination -AclObject $acl}
|
||||||
|
foreach($name in 'ced-network.json','Set-SguCedClientNetwork.ps1'){
|
||||||
|
$source=Join-Path $PSScriptRoot $name
|
||||||
|
$target=Join-Path $destination $name
|
||||||
|
if($source -ine $target -and (-not(Test-Path -LiteralPath $target) -or (Get-FileHash -LiteralPath $source).Hash -ne (Get-FileHash -LiteralPath $target).Hash)){Copy-Item -LiteralPath $source -Destination $target -Force}
|
||||||
|
}
|
||||||
|
$networkConfiguration=[IO.File]::ReadAllText((Join-Path $destination 'ced-network.json'))|ConvertFrom-Json
|
||||||
|
$primaryDomainController=[string]$networkConfiguration.PrimaryController
|
||||||
|
& (Join-Path $destination 'Set-SguCedClientNetwork.ps1')|Out-Null
|
||||||
|
$source=Join-Path $PSScriptRoot 'Repair-SguCedWifi.ps1'
|
||||||
|
$helper=Join-Path $destination 'Repair-SguCedWifi.ps1'
|
||||||
|
if($source -ine $helper -and (-not(Test-Path -LiteralPath $helper) -or (Get-FileHash -LiteralPath $source).Hash -ne (Get-FileHash -LiteralPath $helper).Hash)){Copy-Item -LiteralPath $source -Destination $helper -Force}
|
||||||
|
$service=Get-Service WlanSvc
|
||||||
|
if($service.StartType -ne 'Automatic'){Set-Service WlanSvc -StartupType Automatic}
|
||||||
|
if($service.Status -ne 'Running'){Start-Service WlanSvc}
|
||||||
|
$subscription='<QueryList><Query Id="0" Path="Microsoft-Windows-GroupPolicy/Operational"><Select Path="Microsoft-Windows-GroupPolicy/Operational">*[System[(EventID=8000 or EventID=8002 or EventID=8004 or EventID=8006)]]</Select></Query><Query Id="1" Path="Microsoft-Windows-TerminalServices-LocalSessionManager/Operational"><Select Path="Microsoft-Windows-TerminalServices-LocalSessionManager/Operational">*[System[EventID=23]]</Select></Query><Query Id="2" Path="Microsoft-Windows-WLAN-AutoConfig/Operational"><Select Path="Microsoft-Windows-WLAN-AutoConfig/Operational">*[System[EventID=8001]]</Select></Query></QueryList>'
|
||||||
|
$subscription=[Security.SecurityElement]::Escape($subscription)
|
||||||
|
$command=[Security.SecurityElement]::Escape("$env:WINDIR\System32\WindowsPowerShell\v1.0\powershell.exe")
|
||||||
|
$arguments=[Security.SecurityElement]::Escape('-NoProfile -NonInteractive -ExecutionPolicy Bypass -File "'+$helper+'"')
|
||||||
|
$taskXml=@"
|
||||||
|
<?xml version="1.0" encoding="UTF-16"?>
|
||||||
|
<Task version="1.4" xmlns="http://schemas.microsoft.com/windows/2004/02/mit/task">
|
||||||
|
<RegistrationInfo><Author>La Salle</Author><Description>Computer Wi-Fi recovery after boot, computer policy, logoff or network change. No periodic polling.</Description></RegistrationInfo>
|
||||||
|
<Triggers><BootTrigger><Enabled>true</Enabled><Delay>PT10S</Delay></BootTrigger><EventTrigger><Enabled>true</Enabled><Subscription>$subscription</Subscription><Delay>PT3S</Delay></EventTrigger></Triggers>
|
||||||
|
<Principals><Principal id="System"><UserId>S-1-5-18</UserId><RunLevel>HighestAvailable</RunLevel></Principal></Principals>
|
||||||
|
<Settings><MultipleInstancesPolicy>IgnoreNew</MultipleInstancesPolicy><DisallowStartIfOnBatteries>false</DisallowStartIfOnBatteries><StopIfGoingOnBatteries>false</StopIfGoingOnBatteries><StartWhenAvailable>true</StartWhenAvailable><RunOnlyIfNetworkAvailable>false</RunOnlyIfNetworkAvailable><Enabled>true</Enabled><ExecutionTimeLimit>PT1M</ExecutionTimeLimit></Settings>
|
||||||
|
<Actions Context="System"><Exec><Command>$command</Command><Arguments>$arguments</Arguments></Exec></Actions>
|
||||||
|
</Task>
|
||||||
|
"@
|
||||||
|
$taskName='CED WiFi policy connection'
|
||||||
|
$existing=Get-ScheduledTask -TaskName $taskName -ErrorAction SilentlyContinue
|
||||||
|
$versionFile=Join-Path $destination 'maintenance-v2.sha256'
|
||||||
|
$sha=[Security.Cryptography.SHA256]::Create()
|
||||||
|
try{$hash=[BitConverter]::ToString($sha.ComputeHash([Text.Encoding]::UTF8.GetBytes($taskXml))).Replace('-','')}finally{$sha.Dispose()}
|
||||||
|
$valid=$existing -and $existing.Triggers.Count -eq 2 -and @($existing.Triggers|Where-Object{$_.Repetition.Interval}).Count -eq 0 -and $existing.Principal.UserId -in 'SYSTEM','S-1-5-18' -and (Test-Path -LiteralPath $versionFile) -and (Get-Content -LiteralPath $versionFile -Raw).Trim() -eq $hash
|
||||||
|
if(-not $valid){Register-ScheduledTask -TaskName $taskName -Xml $taskXml -Force|Out-Null;$hash|Set-Content -LiteralPath $versionFile -Encoding ASCII}
|
||||||
|
$profileState=& $helper
|
||||||
|
if(-not $profileState.MachineProfileReady){
|
||||||
|
# Computer authentication reads the existing restricted AD WLAN object.
|
||||||
|
# The PSK stays in memory and Windows encrypts it into its machine store.
|
||||||
|
$searchRoot=$null;$searcher=$null;$found=$null
|
||||||
|
try{
|
||||||
|
# The managed hosts entry directs this FQDN to the Azure public endpoint of
|
||||||
|
# the primary DC; the signed and sealed machine binding protects the read.
|
||||||
|
$domainDn=($computer.Domain.Split('.')|ForEach-Object{'DC='+$_}) -join ','
|
||||||
|
$authentication=[DirectoryServices.AuthenticationTypes]::Secure -bor [DirectoryServices.AuthenticationTypes]::Signing -bor [DirectoryServices.AuthenticationTypes]::Sealing
|
||||||
|
# PowerShell converts null string constructor arguments to empty credentials.
|
||||||
|
# The path-only constructor retains the scheduled task's computer identity.
|
||||||
|
$searchRoot=[DirectoryServices.DirectoryEntry]::new("LDAP://$primaryDomainController/CN=Policies,CN=System,"+$domainDn)
|
||||||
|
$searchRoot.psbase.AuthenticationType=$authentication
|
||||||
|
$searcher=[DirectoryServices.DirectorySearcher]::new($searchRoot)
|
||||||
|
$searcher.ClientTimeout=[TimeSpan]::FromSeconds(10)
|
||||||
|
$searcher.ServerTimeLimit=[TimeSpan]::FromSeconds(10)
|
||||||
|
$searcher.Filter='(&(objectClass=ms-net-ieee-80211-GroupPolicy)(cn=CED Wi-Fi))'
|
||||||
|
[void]$searcher.PropertiesToLoad.Add('ms-net-ieee-80211-GP-PolicyData')
|
||||||
|
$found=$searcher.FindAll()
|
||||||
|
if($found.Count -ne 1){throw 'Expected exactly one authorized CED WLAN policy.'}
|
||||||
|
[xml]$policy=[string]$found[0].Properties['ms-net-ieee-80211-gp-policydata'][0]
|
||||||
|
$profile=$policy.SelectSingleNode('//*[local-name()="WLANProfile"]')
|
||||||
|
$profileState=& $helper -ProvisionXml $profile.OuterXml
|
||||||
|
}finally{if($found){$found.Dispose()};if($searcher){$searcher.Dispose()};if($searchRoot){$searchRoot.psbase.Dispose()};$profile=$null;$policy=$null}
|
||||||
|
}
|
||||||
|
if(-not $profileState.MachineProfileReady){throw 'Machine Wi-Fi profile is not ready.'}
|
||||||
|
$profileState
|
||||||
@@ -0,0 +1,201 @@
|
|||||||
|
[CmdletBinding(SupportsShouldProcess)]
|
||||||
|
param(
|
||||||
|
[string]$Version = '0.6.21',
|
||||||
|
|
||||||
|
[ValidatePattern('^https://')]
|
||||||
|
[string]$ClientPackageUri = 'https://gitea.lci.ulsa.mx/alexrg/SGU-CredentialProvider/releases/download/v0.6.21/sgu-windows-client-bootstrap-0.6.21.zip',
|
||||||
|
|
||||||
|
[ValidatePattern('^[0-9A-Fa-f]{64}$')]
|
||||||
|
[string]$ClientPackageSha256 = '59E2ECCB16A951D5A55D005325B734501868BFB2CFCFEF507A0FE8A1F829C21E',
|
||||||
|
|
||||||
|
[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
|
||||||
|
if ($env:COMPUTERNAME -ine $DomainController.Split('.')[0]) {
|
||||||
|
throw 'Publish on the specified domain controller to keep AD and SYSVOL consistent.'
|
||||||
|
}
|
||||||
|
$consolidationSource = Join-Path $PSScriptRoot 'Invoke-SguWorkstationConsolidation.ps1'
|
||||||
|
if (-not (Test-Path -LiteralPath $consolidationSource)) { throw 'Invoke-SguWorkstationConsolidation.ps1 is required.' }
|
||||||
|
|
||||||
|
$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'
|
||||||
|
`$registered = Get-Item 'HKLM:\SOFTWARE\Classes\CLSID\{D789CFD8-5AD4-489F-9B83-7EB5D9D09335}\InprocServer32' -ErrorAction SilentlyContinue
|
||||||
|
`$display = Get-Item 'HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\Authentication\Credential Providers\{D789CFD8-5AD4-489F-9B83-7EB5D9D09335}' -ErrorAction SilentlyContinue
|
||||||
|
`$providerHealthy = `$registered -and (Test-Path -LiteralPath `$registered.GetValue('')) -and `$display -and `$display.GetValue('') -eq 'Acceso Institucional'
|
||||||
|
if ((Test-Path -LiteralPath `$markerPath -PathType Leaf) -and `$providerHealthy) {
|
||||||
|
& (Join-Path `$PSScriptRoot 'Invoke-SguWorkstationConsolidation.ps1') | Out-Null
|
||||||
|
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))
|
||||||
|
& (Join-Path `$PSScriptRoot 'Invoke-SguWorkstationConsolidation.ps1') | Out-Null
|
||||||
|
"@
|
||||||
|
|
||||||
|
if ($PSCmdlet.ShouldProcess($startupPath, "Install '$scriptName' as a computer startup script")) {
|
||||||
|
New-Item -ItemType Directory -Path $startupPath -Force | Out-Null
|
||||||
|
Copy-Item -LiteralPath $consolidationSource -Destination (Join-Path $startupPath 'Invoke-SguWorkstationConsolidation.ps1') -Force
|
||||||
|
[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()
|
||||||
|
}
|
||||||
@@ -0,0 +1,149 @@
|
|||||||
|
#Requires -Version 5.1
|
||||||
|
[CmdletBinding(SupportsShouldProcess)]
|
||||||
|
param(
|
||||||
|
[string]$CollectorFqdn = "$env:COMPUTERNAME.$env:USERDNSDOMAIN",
|
||||||
|
[string]$ComputerOuDn = 'OU=Laboratorio,DC=lci,DC=lasalle,DC=mx',
|
||||||
|
[string]$MonitoringRoot = 'C:\ProgramData\SGU\Monitoring',
|
||||||
|
[ValidateRange(5,1440)]
|
||||||
|
[int]$InventoryIntervalMinutes = 60,
|
||||||
|
[ValidateRange(30, 730)]
|
||||||
|
[int]$RetentionDays = 183
|
||||||
|
)
|
||||||
|
|
||||||
|
$ErrorActionPreference = 'Stop'
|
||||||
|
$subscriptionId = 'SGU-Lab-Monitoring'
|
||||||
|
$maintenanceScriptName = 'Invoke-SguMonitoringMaintenance.ps1'
|
||||||
|
$reportScriptName = 'Get-SguUsageReport.ps1'
|
||||||
|
$brokerReportScriptName = 'Get-SguBrokerLog.ps1'
|
||||||
|
|
||||||
|
$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 the domain event collector.'
|
||||||
|
}
|
||||||
|
|
||||||
|
Import-Module ActiveDirectory -ErrorAction Stop
|
||||||
|
Get-ADOrganizationalUnit -Identity $ComputerOuDn -ErrorAction Stop | Out-Null
|
||||||
|
|
||||||
|
foreach ($requiredScript in $maintenanceScriptName,$reportScriptName,$brokerReportScriptName) {
|
||||||
|
if (-not (Test-Path -LiteralPath (Join-Path $PSScriptRoot $requiredScript) -PathType Leaf)) {
|
||||||
|
throw "$requiredScript must be beside Install-SguDomainMonitoring.ps1."
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
if ($PSCmdlet.ShouldProcess($env:COMPUTERNAME, 'Install the SGU domain monitoring collector')) {
|
||||||
|
Set-Service EventLog -StartupType Automatic
|
||||||
|
if ((Get-Service EventLog).Status -ne 'Running') {
|
||||||
|
Start-Service EventLog
|
||||||
|
}
|
||||||
|
& wecutil.exe quick-config /quiet
|
||||||
|
if ($LASTEXITCODE -ne 0) {
|
||||||
|
throw "wecutil quick-config failed with exit code $LASTEXITCODE."
|
||||||
|
}
|
||||||
|
Set-Service Wecsvc -StartupType Automatic
|
||||||
|
Start-Service Wecsvc
|
||||||
|
& wevtutil.exe set-log ForwardedEvents /enabled:true /maxsize:536870912 /retention:false /autobackup:false
|
||||||
|
if ($LASTEXITCODE -ne 0) {
|
||||||
|
throw "wevtutil failed to configure ForwardedEvents with exit code $LASTEXITCODE."
|
||||||
|
}
|
||||||
|
|
||||||
|
$query = @'
|
||||||
|
<QueryList>
|
||||||
|
<Query Id="0">
|
||||||
|
<Select Path="Security">*[System[(EventID=4624 or EventID=4625 or EventID=4634 or EventID=4647 or EventID=4778 or EventID=4779)]]</Select>
|
||||||
|
<Select Path="System">*[System[(EventID=12 or EventID=13 or EventID=41 or EventID=1074 or EventID=6005 or EventID=6006 or EventID=6008)]]</Select>
|
||||||
|
</Query>
|
||||||
|
</QueryList>
|
||||||
|
'@
|
||||||
|
$escapedQuery = [Security.SecurityElement]::Escape($query)
|
||||||
|
$subscriptionXml = @"
|
||||||
|
<?xml version="1.0" encoding="UTF-8"?>
|
||||||
|
<Subscription xmlns="http://schemas.microsoft.com/2006/03/windows/events/subscription">
|
||||||
|
<SubscriptionId>$subscriptionId</SubscriptionId>
|
||||||
|
<SubscriptionType>SourceInitiated</SubscriptionType>
|
||||||
|
<Description>SGU interactive sessions, failures, reconnects, and workstation power state.</Description>
|
||||||
|
<Enabled>true</Enabled>
|
||||||
|
<Uri>http://schemas.microsoft.com/wbem/wsman/1/windows/EventLog</Uri>
|
||||||
|
<ConfigurationMode>Custom</ConfigurationMode>
|
||||||
|
<Delivery Mode="Push">
|
||||||
|
<Batching><MaxItems>5</MaxItems><MaxLatencyTime>30000</MaxLatencyTime></Batching>
|
||||||
|
<PushSettings><Heartbeat Interval="60000"/></PushSettings>
|
||||||
|
</Delivery>
|
||||||
|
<Query>$escapedQuery</Query>
|
||||||
|
<ReadExistingEvents>false</ReadExistingEvents>
|
||||||
|
<TransportName>HTTP</TransportName>
|
||||||
|
<ContentFormat>Events</ContentFormat>
|
||||||
|
<Locale Language="es-MX"/>
|
||||||
|
<LogFile>ForwardedEvents</LogFile>
|
||||||
|
<AllowedSourceDomainComputers>O:NSG:NSD:(A;;GA;;;DC)(A;;GA;;;NS)</AllowedSourceDomainComputers>
|
||||||
|
</Subscription>
|
||||||
|
"@
|
||||||
|
|
||||||
|
New-Item -ItemType Directory -Path $MonitoringRoot -Force | Out-Null
|
||||||
|
$subscriptionPath = Join-Path $MonitoringRoot 'SGU-Lab-Monitoring.xml'
|
||||||
|
[IO.File]::WriteAllText($subscriptionPath, $subscriptionXml, [Text.UTF8Encoding]::new($true))
|
||||||
|
$existingSubscriptions = @(& wecutil.exe enum-subscription 2>$null)
|
||||||
|
if ($existingSubscriptions -contains $subscriptionId) {
|
||||||
|
& wecutil.exe delete-subscription $subscriptionId
|
||||||
|
if ($LASTEXITCODE -ne 0) {
|
||||||
|
throw "Could not replace the existing $subscriptionId subscription."
|
||||||
|
}
|
||||||
|
}
|
||||||
|
& wecutil.exe create-subscription $subscriptionPath
|
||||||
|
if ($LASTEXITCODE -ne 0) {
|
||||||
|
throw "Could not create the $subscriptionId subscription."
|
||||||
|
}
|
||||||
|
|
||||||
|
foreach ($scriptName in $maintenanceScriptName,$reportScriptName,$brokerReportScriptName) {
|
||||||
|
Copy-Item -LiteralPath (Join-Path $PSScriptRoot $scriptName) `
|
||||||
|
-Destination (Join-Path $MonitoringRoot $scriptName) -Force
|
||||||
|
}
|
||||||
|
|
||||||
|
$configuration = [ordered]@{
|
||||||
|
CollectorFqdn = $CollectorFqdn
|
||||||
|
ComputerOuDn = $ComputerOuDn
|
||||||
|
RetentionDays = $RetentionDays
|
||||||
|
SubscriptionId = $subscriptionId
|
||||||
|
}
|
||||||
|
[IO.File]::WriteAllText(
|
||||||
|
(Join-Path $MonitoringRoot 'monitoring.json'),
|
||||||
|
($configuration | ConvertTo-Json),
|
||||||
|
[Text.UTF8Encoding]::new($false))
|
||||||
|
|
||||||
|
$powerShell = "$env:SystemRoot\System32\WindowsPowerShell\v1.0\powershell.exe"
|
||||||
|
$maintenanceScript = Join-Path $MonitoringRoot $maintenanceScriptName
|
||||||
|
$inventoryAction = New-ScheduledTaskAction -Execute $powerShell -Argument (
|
||||||
|
"-NoLogo -NoProfile -NonInteractive -ExecutionPolicy Bypass -File `"$maintenanceScript`" " +
|
||||||
|
"-MonitoringRoot `"$MonitoringRoot`" -ComputerOuDn `"$ComputerOuDn`" -RetentionDays $RetentionDays -InventoryOnly")
|
||||||
|
$inventoryTrigger = New-ScheduledTaskTrigger -Once -At (Get-Date).AddMinutes(1) `
|
||||||
|
-RepetitionInterval (New-TimeSpan -Minutes $InventoryIntervalMinutes) `
|
||||||
|
-RepetitionDuration (New-TimeSpan -Days 3650)
|
||||||
|
$taskSettings = New-ScheduledTaskSettingsSet -StartWhenAvailable `
|
||||||
|
-ExecutionTimeLimit (New-TimeSpan -Minutes 10) -RestartCount 2 `
|
||||||
|
-RestartInterval (New-TimeSpan -Minutes 1)
|
||||||
|
Register-ScheduledTask -TaskName 'SGU-Monitoring-Inventory' -Action $inventoryAction `
|
||||||
|
-Trigger $inventoryTrigger -Settings $taskSettings -User 'SYSTEM' -RunLevel Highest -Force | Out-Null
|
||||||
|
|
||||||
|
$retentionAction = New-ScheduledTaskAction -Execute $powerShell -Argument (
|
||||||
|
"-NoLogo -NoProfile -NonInteractive -ExecutionPolicy Bypass -File `"$maintenanceScript`" " +
|
||||||
|
"-MonitoringRoot `"$MonitoringRoot`" -ComputerOuDn `"$ComputerOuDn`" -RetentionDays $RetentionDays")
|
||||||
|
$retentionTrigger = New-ScheduledTaskTrigger -Daily -At '12:10 AM'
|
||||||
|
Register-ScheduledTask -TaskName 'SGU-Monitoring-Retention' -Action $retentionAction `
|
||||||
|
-Trigger $retentionTrigger -Settings $taskSettings -User 'SYSTEM' -RunLevel Highest -Force | Out-Null
|
||||||
|
|
||||||
|
& $maintenanceScript -MonitoringRoot $MonitoringRoot -ComputerOuDn $ComputerOuDn `
|
||||||
|
-RetentionDays $RetentionDays -InventoryOnly | Out-Null
|
||||||
|
}
|
||||||
|
|
||||||
|
[pscustomobject]@{
|
||||||
|
Collector = $CollectorFqdn
|
||||||
|
CollectorService = (Get-Service Wecsvc).Status.ToString()
|
||||||
|
SubscriptionId = $subscriptionId
|
||||||
|
SubscriptionEnabled = @(& wecutil.exe enum-subscription) -contains $subscriptionId
|
||||||
|
RetentionDays = $RetentionDays
|
||||||
|
InventoryTask = (Get-ScheduledTask -TaskName 'SGU-Monitoring-Inventory').State
|
||||||
|
RetentionTask = (Get-ScheduledTask -TaskName 'SGU-Monitoring-Retention').State
|
||||||
|
MachineStatusPath = Join-Path $MonitoringRoot 'Reports\machine-status.json'
|
||||||
|
UsageReportCommand = "& '$MonitoringRoot\$reportScriptName'"
|
||||||
|
BrokerLogCommand = "& '$MonitoringRoot\$brokerReportScriptName'"
|
||||||
|
}
|
||||||
@@ -0,0 +1,195 @@
|
|||||||
|
[CmdletBinding()]
|
||||||
|
param(
|
||||||
|
[string]$GpoName = 'La Salle - Workstation remote management',
|
||||||
|
[string]$DomainController = $env:COMPUTERNAME,
|
||||||
|
[string[]]$ManagementAddresses = @('LocalSubnet'),
|
||||||
|
[string]$LocalDnsServer = '',
|
||||||
|
[string]$FallbackDnsServer = ''
|
||||||
|
)
|
||||||
|
|
||||||
|
$ErrorActionPreference = 'Stop'
|
||||||
|
Import-Module ActiveDirectory
|
||||||
|
Import-Module GroupPolicy
|
||||||
|
Import-Module NetSecurity
|
||||||
|
$domain = Get-ADDomain -Server $DomainController
|
||||||
|
$dnsRoot = $domain.DNSRoot
|
||||||
|
$domainDn = $domain.DistinguishedName
|
||||||
|
$gpo = Get-GPO -Name $GpoName -Domain $dnsRoot -Server $DomainController -ErrorAction SilentlyContinue
|
||||||
|
$changes = [Collections.Generic.List[string]]::new()
|
||||||
|
if (-not $gpo) {
|
||||||
|
$gpo = New-GPO -Name $GpoName -Domain $dnsRoot -Server $DomainController
|
||||||
|
$changes.Add('Created GPO')
|
||||||
|
}
|
||||||
|
if ($gpo.GpoStatus -ne 'UserSettingsDisabled') {
|
||||||
|
$gpo.GpoStatus = [Microsoft.GroupPolicy.GpoStatus]::UserSettingsDisabled
|
||||||
|
$changes.Add('Computer settings only')
|
||||||
|
}
|
||||||
|
$policyDn = "CN={$($gpo.Id)},CN=Policies,CN=System,$domainDn"
|
||||||
|
$policyRoot = Join-Path $env:WINDIR "SYSVOL\domain\Policies\{$($gpo.Id)}"
|
||||||
|
|
||||||
|
# Domain-root inheritance includes newly joined computers in CN=Computers.
|
||||||
|
# The WMI filter limits the policy to workstation OSes (Windows 10 and 11).
|
||||||
|
$filterName = 'La Salle - Windows workstations'
|
||||||
|
$filter = Get-ADObject -Server $DomainController -SearchBase "CN=SOM,CN=WMIPolicy,CN=System,$domainDn" `
|
||||||
|
-LDAPFilter '(objectClass=msWMI-Som)' -Properties msWMI-Name,msWMI-ID,msWMI-Parm2 |
|
||||||
|
Where-Object { $_.'msWMI-Name' -eq $filterName }
|
||||||
|
$query = 'SELECT * FROM Win32_OperatingSystem WHERE ProductType = 1'
|
||||||
|
$encodedQuery = "1;3;10;$($query.Length);WQL;root\CIMv2;$query;"
|
||||||
|
if (@($filter).Count -gt 1) { throw 'Duplicate workstation WMI filters; inspect before editing.' }
|
||||||
|
if (-not $filter) {
|
||||||
|
$filterId = '{' + [guid]::NewGuid().ToString().ToUpperInvariant() + '}'
|
||||||
|
$timestamp = (Get-Date).ToUniversalTime().ToString('yyyyMMddHHmmss.ffffff-000')
|
||||||
|
$filter = New-ADObject -Server $DomainController -Name $filterId -Type msWMI-Som `
|
||||||
|
-Path "CN=SOM,CN=WMIPolicy,CN=System,$domainDn" -OtherAttributes @{
|
||||||
|
'msWMI-Name' = $filterName; 'msWMI-ID' = $filterId
|
||||||
|
'msWMI-Parm1' = 'Domain workstation management; excludes servers and DCs.'
|
||||||
|
'msWMI-Parm2' = $encodedQuery; 'msWMI-Author' = 'Domain administrators'
|
||||||
|
'msWMI-CreationDate' = $timestamp; 'msWMI-ChangeDate' = $timestamp
|
||||||
|
} -PassThru
|
||||||
|
$filter = Get-ADObject $filter.DistinguishedName -Server $DomainController -Properties msWMI-ID
|
||||||
|
$changes.Add('Created workstation filter')
|
||||||
|
} elseif ($filter.'msWMI-Parm2' -ne $encodedQuery) {
|
||||||
|
throw 'Existing workstation filter has a different query; inspect before changing it.'
|
||||||
|
}
|
||||||
|
$filterReference = "[$dnsRoot;$($filter.'msWMI-ID');0]"
|
||||||
|
$policy = Get-ADObject $policyDn -Server $DomainController -Properties gPCWQLFilter
|
||||||
|
if ($policy.gPCWQLFilter -ne $filterReference) {
|
||||||
|
Set-ADObject $policyDn -Server $DomainController -Replace @{gPCWQLFilter=$filterReference}
|
||||||
|
$changes.Add('Linked workstation filter')
|
||||||
|
}
|
||||||
|
|
||||||
|
$registry = @(
|
||||||
|
@{Key='HKLM\Software\Policies\Microsoft\Windows NT\Terminal Services'; Name='fDenyTSConnections'; Type='DWord'; Value=0},
|
||||||
|
@{Key='HKLM\Software\Policies\Microsoft\Windows NT\Terminal Services'; Name='UserAuthentication'; Type='DWord'; Value=1},
|
||||||
|
@{Key='HKLM\Software\Policies\Microsoft\Windows\WinRM\Service'; Name='AllowAutoConfig'; Type='DWord'; Value=1},
|
||||||
|
@{Key='HKLM\Software\Policies\Microsoft\Windows\WinRM\Service'; Name='IPv4Filter'; Type='String'; Value='*'},
|
||||||
|
@{Key='HKLM\Software\Policies\Microsoft\Windows\WinRM\Service'; Name='IPv6Filter'; Type='String'; Value='*'},
|
||||||
|
@{Key='HKLM\Software\Policies\Microsoft\Windows\WinRM\Service\WinRS'; Name='AllowRemoteShellAccess'; Type='DWord'; Value=1}
|
||||||
|
)
|
||||||
|
foreach ($setting in $registry) {
|
||||||
|
$current = Get-GPRegistryValue -Name $GpoName -Domain $dnsRoot -Server $DomainController `
|
||||||
|
-Key $setting.Key -ValueName $setting.Name -ErrorAction SilentlyContinue
|
||||||
|
if (-not $current -or [string]$current.Value -ne [string]$setting.Value -or [string]$current.Type -ne $setting.Type) {
|
||||||
|
Set-GPRegistryValue -Name $GpoName -Domain $dnsRoot -Server $DomainController `
|
||||||
|
-Key $setting.Key -ValueName $setting.Name -Type $setting.Type -Value $setting.Value | Out-Null
|
||||||
|
$changes.Add("Registry: $($setting.Name)")
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
# Firewall policy is enforced by the native firewall CSE, including gpupdate.
|
||||||
|
# RPC dynamic ports are restricted to their Windows service, not opened broadly.
|
||||||
|
$ruleDefinitions = @(
|
||||||
|
@{Name='WinRM'; Protocol='TCP'; Port='5985'; Service='WinRM'},
|
||||||
|
@{Name='RDP-TCP'; Protocol='TCP'; Port='3389'; Service='TermService'},
|
||||||
|
@{Name='RDP-UDP'; Protocol='UDP'; Port='3389'; Service='TermService'},
|
||||||
|
@{Name='RPC-Endpoint'; Protocol='TCP'; Port='RPCEPMap'; Service='RpcSs'},
|
||||||
|
@{Name='WMI'; Protocol='TCP'; Port='Any'; Service='winmgmt'},
|
||||||
|
@{Name='EventLog'; Protocol='TCP'; Port='RPC'; Service='EventLog'},
|
||||||
|
@{Name='Services'; Protocol='TCP'; Port='RPC'; Service='services.exe'; Program='%SystemRoot%\System32\services.exe'},
|
||||||
|
@{Name='Tasks'; Protocol='TCP'; Port='RPC'; Service='Schedule'},
|
||||||
|
@{Name='Firewall'; Protocol='TCP'; Port='RPC'; Service='MpsSvc'},
|
||||||
|
@{Name='Volumes'; Protocol='TCP'; Port='RPC'; Service='vds'},
|
||||||
|
@{Name='Performance'; Protocol='TCP'; Port='RPC'; Service='pla'},
|
||||||
|
@{Name='SMB'; Protocol='TCP'; Port='445'; Service='LanmanServer'; Program='System'}
|
||||||
|
)
|
||||||
|
$session = Open-NetGPO -PolicyStore "$dnsRoot\$GpoName" -DomainController $DomainController
|
||||||
|
$firewallChanged = $false
|
||||||
|
foreach ($definition in $ruleDefinitions) {
|
||||||
|
$name = 'LaSalle-Management-' + $definition.Name
|
||||||
|
$program = '%SystemRoot%\System32\svchost.exe'
|
||||||
|
$service = $definition.Service
|
||||||
|
if ($definition.Program) { $program = $definition.Program }
|
||||||
|
if ($service -eq 'services.exe') { $service = 'Any' }
|
||||||
|
$existing = Get-NetFirewallRule -GPOSession $session -Name $name -ErrorAction SilentlyContinue
|
||||||
|
$valid = $false
|
||||||
|
if ($existing) {
|
||||||
|
$port = $existing | Get-NetFirewallPortFilter
|
||||||
|
$address = $existing | Get-NetFirewallAddressFilter
|
||||||
|
$application = $existing | Get-NetFirewallApplicationFilter
|
||||||
|
$svc = $existing | Get-NetFirewallServiceFilter
|
||||||
|
$valid = $existing.Enabled -eq 'True' -and $existing.Profile -eq 'Any' -and
|
||||||
|
$existing.Action -eq 'Allow' -and $existing.Direction -eq 'Inbound' -and
|
||||||
|
[string]$port.Protocol -eq $definition.Protocol -and [string]$port.LocalPort -eq $definition.Port -and
|
||||||
|
$application.Program -eq $program -and $svc.Service -eq $service -and
|
||||||
|
-not @(Compare-Object @($address.RemoteAddress) $ManagementAddresses).Count
|
||||||
|
}
|
||||||
|
if ($valid) { continue }
|
||||||
|
if ($existing) { $existing | Remove-NetFirewallRule }
|
||||||
|
New-NetFirewallRule -GPOSession $session -Name $name -DisplayName $name `
|
||||||
|
-Group 'La Salle remote management' -Enabled True -Direction Inbound -Action Allow `
|
||||||
|
-Profile Any -Protocol $definition.Protocol -LocalPort $definition.Port `
|
||||||
|
-Program $program -Service $service -RemoteAddress $ManagementAddresses | Out-Null
|
||||||
|
$firewallChanged = $true
|
||||||
|
$changes.Add("Firewall: $name")
|
||||||
|
}
|
||||||
|
if ($firewallChanged) { Save-NetGPO -GPOSession $session }
|
||||||
|
|
||||||
|
function Set-PolicyFile([string]$RelativePath, [string]$Content) {
|
||||||
|
$path = Join-Path $policyRoot $RelativePath
|
||||||
|
if ((Test-Path -LiteralPath $path) -and [IO.File]::ReadAllText($path) -eq $Content) { return $false }
|
||||||
|
New-Item -ItemType Directory -Path (Split-Path $path) -Force | Out-Null
|
||||||
|
[IO.File]::WriteAllText($path, $Content, [Text.UTF8Encoding]::new($false))
|
||||||
|
$changes.Add("File: $RelativePath")
|
||||||
|
return $true
|
||||||
|
}
|
||||||
|
$servicesXml = @'
|
||||||
|
<?xml version="1.0" encoding="utf-8"?>
|
||||||
|
<NTServices clsid="{2CFB484A-4E96-4b5d-A0B6-093D2F91E6AE}">
|
||||||
|
<NTService clsid="{AB6F0B67-341F-4e51-92F9-005FBFBA1A43}" name="WinRM" image="2" uid="{49771BD6-DA5C-4138-9C1A-E9CAAC7194F1}"><Properties startupType="AUTOMATIC" serviceName="WinRM" serviceAction="RESTART_IF_REQUIRED" timeout="30" /></NTService>
|
||||||
|
<NTService clsid="{AB6F0B67-341F-4e51-92F9-005FBFBA1A43}" name="TermService" image="2" uid="{05CF2CCF-006A-4829-92CD-9FF53867942E}"><Properties startupType="AUTOMATIC" serviceName="TermService" serviceAction="RESTART_IF_REQUIRED" timeout="30" /></NTService>
|
||||||
|
<NTService clsid="{AB6F0B67-341F-4e51-92F9-005FBFBA1A43}" name="RemoteRegistry" image="2" uid="{B09673B4-1054-4D2D-A29D-4203E2E7B60C}"><Properties startupType="MANUAL" serviceName="RemoteRegistry" serviceAction="NOCHANGE" timeout="30" /></NTService>
|
||||||
|
</NTServices>
|
||||||
|
'@
|
||||||
|
$fileChanged = Set-PolicyFile 'Machine\Preferences\Services\Services.xml' $servicesXml
|
||||||
|
$registryXml = @'
|
||||||
|
<?xml version="1.0" encoding="utf-8"?>
|
||||||
|
<RegistrySettings clsid="{A3CCFC41-DFDB-43a5-8D26-0FE8B954DA51}">
|
||||||
|
<Registry clsid="{9CD4B2F4-923D-47f5-A062-E897DD1DAD50}" name="fDenyTSConnections" status="fDenyTSConnections" image="2" uid="{65FCC5F4-38E4-4A55-A8E0-B41BF7F79CDD}"><Properties action="U" hive="HKEY_LOCAL_MACHINE" key="SYSTEM\CurrentControlSet\Control\Terminal Server" name="fDenyTSConnections" type="REG_DWORD" value="00000000" /></Registry>
|
||||||
|
<Registry clsid="{9CD4B2F4-923D-47f5-A062-E897DD1DAD50}" name="UserAuthentication" status="UserAuthentication" image="2" uid="{7F6126E4-534C-4AF6-8D9C-CB8642D1607C}"><Properties action="U" hive="HKEY_LOCAL_MACHINE" key="SYSTEM\CurrentControlSet\Control\Terminal Server\WinStations\RDP-Tcp" name="UserAuthentication" type="REG_DWORD" value="00000001" /></Registry>
|
||||||
|
</RegistrySettings>
|
||||||
|
'@
|
||||||
|
$fileChanged = (Set-PolicyFile 'Machine\Preferences\Registry\Registry.xml' $registryXml) -or $fileChanged
|
||||||
|
$helperName = 'Enable-SguWorkstationRemoteAccess.ps1'
|
||||||
|
$helper = [IO.File]::ReadAllText((Join-Path $PSScriptRoot $helperName))
|
||||||
|
$fileChanged = (Set-PolicyFile "Machine\Scripts\Startup\$helperName" $helper) -or $fileChanged
|
||||||
|
$parameters = "-NoProfile -NonInteractive -ExecutionPolicy Bypass -File `"\\$dnsRoot\SYSVOL\$dnsRoot\Policies\{$($gpo.Id)}\Machine\Scripts\Startup\$helperName`""
|
||||||
|
if ($LocalDnsServer) {
|
||||||
|
[Net.IPAddress]::Parse($LocalDnsServer) | Out-Null
|
||||||
|
$parameters += " -LocalDnsServer $LocalDnsServer"
|
||||||
|
if ($FallbackDnsServer) {
|
||||||
|
[Net.IPAddress]::Parse($FallbackDnsServer) | Out-Null
|
||||||
|
$parameters += " -FallbackDnsServer $FallbackDnsServer"
|
||||||
|
}
|
||||||
|
} elseif ($FallbackDnsServer) {
|
||||||
|
throw 'FallbackDnsServer requires a LocalDnsServer.'
|
||||||
|
}
|
||||||
|
$scriptsIni = "[Startup]`r`n0CmdLine=powershell.exe`r`n0Parameters=$parameters`r`n"
|
||||||
|
$fileChanged = (Set-PolicyFile 'Machine\Scripts\scripts.ini' $scriptsIni) -or $fileChanged
|
||||||
|
|
||||||
|
$policy = Get-ADObject $policyDn -Server $DomainController -Properties gPCMachineExtensionNames,versionNumber
|
||||||
|
$extensions = [string]$policy.gPCMachineExtensionNames
|
||||||
|
foreach ($extension in @(
|
||||||
|
'[{B087BE9D-ED37-454F-AF9C-04291E351182}{BEE07A6A-EC9F-4659-B8C9-0B193F6C7FE2}]',
|
||||||
|
'[{91FBB303-0CD5-4055-BF42-E512A681B325}{CC5746A9-9B74-4BE5-AE2E-64379C86E0E4}]',
|
||||||
|
'[{42B5FAAE-6536-11D2-AE5A-0000F87571E3}{40B6664F-4972-11D1-A7CA-0000F87571E3}]'
|
||||||
|
)) {
|
||||||
|
if (-not $extensions.Contains($extension)) { $extensions += $extension; $fileChanged = $true }
|
||||||
|
}
|
||||||
|
if ($fileChanged) {
|
||||||
|
# Preserve the user-version word. Sort CSEs as required by Group Policy.
|
||||||
|
$extensions = (@([regex]::Matches($extensions, '\[[^\]]+\]') | ForEach-Object Value | Sort-Object -Unique) -join '')
|
||||||
|
$oldVersion = [long]$policy.versionNumber
|
||||||
|
$version = ($oldVersion -band 0xFFFF0000L) -bor (($oldVersion + 1) -band 0xFFFFL)
|
||||||
|
Set-ADObject $policyDn -Server $DomainController -Replace @{gPCMachineExtensionNames=$extensions; versionNumber=[int]$version}
|
||||||
|
[IO.File]::WriteAllText((Join-Path $policyRoot 'GPT.INI'), "[General]`r`nVersion=$version`r`n", [Text.UTF8Encoding]::new($false))
|
||||||
|
}
|
||||||
|
$links = @(Get-GPInheritance -Target $domainDn -Domain $dnsRoot -Server $DomainController).GpoLinks
|
||||||
|
$link = $links | Where-Object { $_.GpoId -eq $gpo.Id }
|
||||||
|
if (-not $link) {
|
||||||
|
New-GPLink -Guid $gpo.Id -Target $domainDn -Domain $dnsRoot -Server $DomainController -LinkEnabled Yes -Enforced Yes | Out-Null
|
||||||
|
$changes.Add('Linked at domain root')
|
||||||
|
} elseif (-not $link.Enabled -or -not $link.Enforced) {
|
||||||
|
Set-GPLink -Guid $gpo.Id -Target $domainDn -Domain $dnsRoot -Server $DomainController -LinkEnabled Yes -Enforced Yes | Out-Null
|
||||||
|
$changes.Add('Enabled enforced domain link')
|
||||||
|
}
|
||||||
|
[pscustomobject]@{Gpo=$GpoName; Id=[string]$gpo.Id; Domain=$dnsRoot; Changed=($changes.Count -gt 0); Changes=@($changes.ToArray())}
|
||||||
@@ -19,15 +19,23 @@ param(
|
|||||||
[ValidateRange(2, 90)]
|
[ValidateRange(2, 90)]
|
||||||
[int]$TimeoutSeconds = 90,
|
[int]$TimeoutSeconds = 90,
|
||||||
[string]$RemoteDesktopPrincipal = 'LCI\SG-Laboratorio-Usuarios-RDP',
|
[string]$RemoteDesktopPrincipal = 'LCI\SG-Laboratorio-Usuarios-RDP',
|
||||||
[string]$DotNetRuntimeInstallerPath
|
[string]$DotNetRuntimeInstallerPath,
|
||||||
|
[string]$RustDeskServerAddress,
|
||||||
|
[string]$RustDeskServerPublicKey
|
||||||
)
|
)
|
||||||
|
|
||||||
$ErrorActionPreference = 'Stop'
|
$ErrorActionPreference = 'Stop'
|
||||||
|
if ((Get-ItemProperty 'HKLM:\SOFTWARE\Policies\LaSalle\ClientMaintenance' -Name ProviderManagedByGpo -ErrorAction SilentlyContinue).ProviderManagedByGpo -eq 1) {
|
||||||
|
return
|
||||||
|
}
|
||||||
$taskName = 'SGU-CredentialProvider-EnrollmentGuard'
|
$taskName = 'SGU-CredentialProvider-EnrollmentGuard'
|
||||||
$enrollmentRoot = Join-Path $env:ProgramData 'SGU\Enrollment'
|
$enrollmentRoot = Join-Path $env:ProgramData 'SGU\Enrollment'
|
||||||
$sourceScripts = @(
|
$sourceScripts = @(
|
||||||
'Install-CredentialProvider.ps1',
|
'Install-CredentialProvider.ps1',
|
||||||
'Enable-LabRemoteAccess.ps1',
|
'Enable-LabRemoteAccess.ps1',
|
||||||
|
'Enable-SguClientMonitoring.ps1',
|
||||||
|
'Install-SguRustDeskClient.ps1',
|
||||||
|
'Set-SguStandardLocalUser.ps1',
|
||||||
'Test-SguClientEnrollment.ps1',
|
'Test-SguClientEnrollment.ps1',
|
||||||
'Repair-SguClientEnrollment.ps1'
|
'Repair-SguClientEnrollment.ps1'
|
||||||
)
|
)
|
||||||
@@ -53,6 +61,10 @@ if ($DotNetRuntimeInstallerPath -and
|
|||||||
-not (Test-Path -LiteralPath $DotNetRuntimeInstallerPath -PathType Leaf)) {
|
-not (Test-Path -LiteralPath $DotNetRuntimeInstallerPath -PathType Leaf)) {
|
||||||
throw 'DotNetRuntimeInstallerPath does not exist.'
|
throw 'DotNetRuntimeInstallerPath does not exist.'
|
||||||
}
|
}
|
||||||
|
if ([string]::IsNullOrWhiteSpace($RustDeskServerAddress) -xor
|
||||||
|
[string]::IsNullOrWhiteSpace($RustDeskServerPublicKey)) {
|
||||||
|
throw 'RustDeskServerAddress and RustDeskServerPublicKey must be supplied together.'
|
||||||
|
}
|
||||||
|
|
||||||
if ($PSCmdlet.ShouldProcess($enrollmentRoot, 'Install the SGU enrollment repair guard')) {
|
if ($PSCmdlet.ShouldProcess($enrollmentRoot, 'Install the SGU enrollment repair guard')) {
|
||||||
New-Item -ItemType Directory -Path $enrollmentRoot -Force | Out-Null
|
New-Item -ItemType Directory -Path $enrollmentRoot -Force | Out-Null
|
||||||
@@ -87,6 +99,8 @@ if ($PSCmdlet.ShouldProcess($enrollmentRoot, 'Install the SGU enrollment repair
|
|||||||
TimeoutSeconds = $TimeoutSeconds
|
TimeoutSeconds = $TimeoutSeconds
|
||||||
RemoteDesktopPrincipal = $RemoteDesktopPrincipal
|
RemoteDesktopPrincipal = $RemoteDesktopPrincipal
|
||||||
DotNetRuntimeInstallerPath = $guardRuntimeInstaller
|
DotNetRuntimeInstallerPath = $guardRuntimeInstaller
|
||||||
|
RustDeskServerAddress = $RustDeskServerAddress
|
||||||
|
RustDeskServerPublicKey = $RustDeskServerPublicKey
|
||||||
}
|
}
|
||||||
$configurationPath = Join-Path $enrollmentRoot 'enrollment.json'
|
$configurationPath = Join-Path $enrollmentRoot 'enrollment.json'
|
||||||
[IO.File]::WriteAllText(
|
[IO.File]::WriteAllText(
|
||||||
|
|||||||
@@ -0,0 +1,67 @@
|
|||||||
|
#Requires -Version 5.1
|
||||||
|
[CmdletBinding(SupportsShouldProcess)]
|
||||||
|
param(
|
||||||
|
[Parameter(Mandatory)][string]$InstallerPath
|
||||||
|
)
|
||||||
|
|
||||||
|
$ErrorActionPreference = 'Stop'
|
||||||
|
$identity = [Security.Principal.WindowsIdentity]::GetCurrent()
|
||||||
|
$principal = [Security.Principal.WindowsPrincipal]::new($identity)
|
||||||
|
if (-not $principal.IsInRole([Security.Principal.WindowsBuiltInRole]::Administrator)) {
|
||||||
|
throw 'Run the FSLogix installer from an elevated Windows PowerShell session.'
|
||||||
|
}
|
||||||
|
|
||||||
|
$appsRoot = Join-Path $env:ProgramFiles 'FSLogix\Apps'
|
||||||
|
$frxPath = Join-Path $appsRoot 'frx.exe'
|
||||||
|
$service = Get-Service -Name frxsvc -ErrorAction SilentlyContinue
|
||||||
|
if ($service -and (Test-Path -LiteralPath $frxPath -PathType Leaf)) {
|
||||||
|
$versionOutput = @(& $frxPath version 2>&1) -join [Environment]::NewLine
|
||||||
|
return [pscustomobject]@{
|
||||||
|
Installed = $true
|
||||||
|
Changed = $false
|
||||||
|
RestartRequired = $false
|
||||||
|
Service = $service.Status.ToString()
|
||||||
|
Version = $versionOutput.Trim()
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
if (-not (Test-Path -LiteralPath $InstallerPath -PathType Leaf)) {
|
||||||
|
throw "FSLogixAppsSetup.exe was not found: $InstallerPath"
|
||||||
|
}
|
||||||
|
$resolvedInstaller = (Resolve-Path -LiteralPath $InstallerPath).Path
|
||||||
|
if ([IO.Path]::GetFileName($resolvedInstaller) -ne 'FSLogixAppsSetup.exe') {
|
||||||
|
throw 'InstallerPath must identify the Microsoft FSLogix core installer named FSLogixAppsSetup.exe.'
|
||||||
|
}
|
||||||
|
$signature = Get-AuthenticodeSignature -LiteralPath $resolvedInstaller
|
||||||
|
if ($signature.Status -ne [Management.Automation.SignatureStatus]::Valid -or
|
||||||
|
-not $signature.SignerCertificate -or
|
||||||
|
$signature.SignerCertificate.Subject -notmatch '(^|,\s*)CN=Microsoft Corporation(,|$)') {
|
||||||
|
throw 'FSLogixAppsSetup.exe must have a valid Microsoft Corporation Authenticode signature.'
|
||||||
|
}
|
||||||
|
|
||||||
|
$logRoot = Join-Path $env:ProgramData 'SGU\FSLogix'
|
||||||
|
$logPath = Join-Path $logRoot 'install.log'
|
||||||
|
if (-not $PSCmdlet.ShouldProcess($env:COMPUTERNAME, 'Install Microsoft FSLogix Apps without restarting')) {
|
||||||
|
return
|
||||||
|
}
|
||||||
|
New-Item -ItemType Directory -Path $logRoot -Force | Out-Null
|
||||||
|
$process = Start-Process -FilePath $resolvedInstaller `
|
||||||
|
-ArgumentList @('/install', '/quiet', '/norestart', '/log', "`"$logPath`"") `
|
||||||
|
-Wait -PassThru -WindowStyle Hidden
|
||||||
|
if ($process.ExitCode -notin @(0, 1641, 3010)) {
|
||||||
|
throw "FSLogix installation failed with exit code $($process.ExitCode). Review $logPath."
|
||||||
|
}
|
||||||
|
|
||||||
|
$service = Get-Service -Name frxsvc -ErrorAction SilentlyContinue
|
||||||
|
if (-not $service -or -not (Test-Path -LiteralPath $frxPath -PathType Leaf)) {
|
||||||
|
throw "FSLogix installation did not create the frxsvc service and frx.exe. Review $logPath."
|
||||||
|
}
|
||||||
|
$versionOutput = @(& $frxPath version 2>&1) -join [Environment]::NewLine
|
||||||
|
[pscustomobject]@{
|
||||||
|
Installed = $true
|
||||||
|
Changed = $true
|
||||||
|
RestartRequired = $true
|
||||||
|
Service = $service.Status.ToString()
|
||||||
|
Version = $versionOutput.Trim()
|
||||||
|
LogPath = $logPath
|
||||||
|
}
|
||||||
@@ -0,0 +1,427 @@
|
|||||||
|
#!/usr/bin/env bash
|
||||||
|
# Install-SguLinuxRustDeskClient.sh
|
||||||
|
#
|
||||||
|
# Installs/configures a RustDesk client on an AD-joined Linux workstation and
|
||||||
|
# registers its randomly generated unattended-access credential with the
|
||||||
|
# protected inventory on the SGU domain controller. The credential is never
|
||||||
|
# emitted to stdout and is sent to the controller only in an RSA-OAEP envelope.
|
||||||
|
|
||||||
|
set -Eeuo pipefail
|
||||||
|
IFS=$'\n\t'
|
||||||
|
|
||||||
|
DOMAIN_NAME='lci.lasalle.mx'
|
||||||
|
REGISTRATION_SHARE=''
|
||||||
|
STATE_ROOT='/var/lib/sgu/rustdesk'
|
||||||
|
CLIENT_VERSION='1.4.9'
|
||||||
|
DOWNLOAD_URI='https://github.com/rustdesk/rustdesk/releases/download/1.4.9/rustdesk-1.4.9-x86_64.deb'
|
||||||
|
EXPECTED_SHA256='7244BA47C40E804172044BFBE659467C54CE46554C98E78C8C0406F1D612FDA3'
|
||||||
|
|
||||||
|
usage() {
|
||||||
|
cat <<'EOF'
|
||||||
|
Usage:
|
||||||
|
sudo ./Install-SguLinuxRustDeskClient.sh [options]
|
||||||
|
|
||||||
|
Options:
|
||||||
|
--domain-name VALUE AD DNS domain (default: lci.lasalle.mx).
|
||||||
|
--registration-share UNC SMB enrollment share. Defaults to the first
|
||||||
|
AD domain controller's SGU RustDesk share.
|
||||||
|
--state-root PATH Root-owned local RustDesk state directory.
|
||||||
|
--help Show this help.
|
||||||
|
|
||||||
|
The computer must already be joined to Active Directory. The script uses the
|
||||||
|
machine keytab to authenticate to the enrollment share, configures the
|
||||||
|
self-hosted RustDesk server, creates an unattended-access password, and waits
|
||||||
|
for the controller to confirm protected inventory registration.
|
||||||
|
EOF
|
||||||
|
}
|
||||||
|
|
||||||
|
fail() {
|
||||||
|
printf 'ERROR: %s\n' "$*" >&2
|
||||||
|
exit 1
|
||||||
|
}
|
||||||
|
|
||||||
|
need_command() {
|
||||||
|
command -v "$1" >/dev/null 2>&1 || fail "Required command is unavailable: $1"
|
||||||
|
}
|
||||||
|
|
||||||
|
apt_get_with_retry() {
|
||||||
|
local attempt
|
||||||
|
for attempt in $(seq 1 60); do
|
||||||
|
if apt-get "$@"; then
|
||||||
|
return 0
|
||||||
|
fi
|
||||||
|
if fuser /var/lib/dpkg/lock-frontend /var/lib/dpkg/lock /var/lib/apt/lists/lock \
|
||||||
|
>/dev/null 2>&1; then
|
||||||
|
printf 'Waiting for another package operation before retrying apt-get %s.\n' "$1" >&2
|
||||||
|
sleep 5
|
||||||
|
continue
|
||||||
|
fi
|
||||||
|
fail "apt-get $1 failed for a reason other than a temporary package lock."
|
||||||
|
done
|
||||||
|
fail 'Timed out waiting for another package operation to finish.'
|
||||||
|
}
|
||||||
|
|
||||||
|
while (($#)); do
|
||||||
|
case "$1" in
|
||||||
|
--domain-name) DOMAIN_NAME=${2:?Missing value for --domain-name}; shift 2 ;;
|
||||||
|
--registration-share) REGISTRATION_SHARE=${2:?Missing value for --registration-share}; shift 2 ;;
|
||||||
|
--state-root) STATE_ROOT=${2:?Missing value for --state-root}; shift 2 ;;
|
||||||
|
--help|-h) usage; exit 0 ;;
|
||||||
|
*) fail "Unknown argument: $1. Use --help for usage." ;;
|
||||||
|
esac
|
||||||
|
done
|
||||||
|
|
||||||
|
[[ ${EUID} -eq 0 ]] || fail 'Run this command with sudo or as root.'
|
||||||
|
[[ -r /etc/krb5.keytab ]] || fail 'The AD machine keytab is missing. Join the computer to the domain first.'
|
||||||
|
|
||||||
|
install_prerequisites() {
|
||||||
|
if command -v apt-get >/dev/null 2>&1; then
|
||||||
|
export DEBIAN_FRONTEND=noninteractive
|
||||||
|
apt_get_with_retry update
|
||||||
|
apt_get_with_retry install -y curl openssl smbclient dnsutils
|
||||||
|
return
|
||||||
|
fi
|
||||||
|
if command -v dnf >/dev/null 2>&1; then
|
||||||
|
dnf install -y curl openssl samba-client bind-utils
|
||||||
|
return
|
||||||
|
fi
|
||||||
|
fail 'RustDesk enrollment supports apt-get (Debian/Ubuntu) and dnf (RHEL/Fedora/Rocky/AlmaLinux).'
|
||||||
|
}
|
||||||
|
|
||||||
|
resolve_registration_share() {
|
||||||
|
if [[ -n $REGISTRATION_SHARE ]]; then
|
||||||
|
return
|
||||||
|
fi
|
||||||
|
|
||||||
|
local controller
|
||||||
|
controller=$(host -t SRV "_ldap._tcp.dc._msdcs.${DOMAIN_NAME}" 2>/dev/null |
|
||||||
|
awk '/SRV record/ { print $NF; exit }' | sed 's/\.$//')
|
||||||
|
[[ -n $controller ]] || controller=$DOMAIN_NAME
|
||||||
|
REGISTRATION_SHARE="//${controller}/SGU-RustDesk-Enrollment$"
|
||||||
|
}
|
||||||
|
|
||||||
|
initialize_machine_kerberos() {
|
||||||
|
local principal
|
||||||
|
# adcli places the machine-account principal in the keytab. Prefer it to
|
||||||
|
# host/FQDN: some AD deployments retain the latter locally even when its
|
||||||
|
# SPN is not accepted by the KDC for an initial ticket request.
|
||||||
|
principal=$(klist -k /etc/krb5.keytab 2>/dev/null |
|
||||||
|
awk '$NF ~ /^[^/@]+\$@/ { print $NF; exit }')
|
||||||
|
if [[ -z $principal ]]; then
|
||||||
|
principal=$(klist -k /etc/krb5.keytab 2>/dev/null |
|
||||||
|
awk '$NF ~ /^host\// { print $NF; exit }')
|
||||||
|
fi
|
||||||
|
[[ -n $principal ]] || fail 'No host principal was found in /etc/krb5.keytab.'
|
||||||
|
|
||||||
|
KRB5CCNAME="FILE:${STATE_ROOT}/machine-krb5cc"
|
||||||
|
export KRB5CCNAME
|
||||||
|
rm -f -- "${KRB5CCNAME#FILE:}"
|
||||||
|
kinit -k -t /etc/krb5.keytab "$principal"
|
||||||
|
}
|
||||||
|
|
||||||
|
smb_get() {
|
||||||
|
local remote_name=$1
|
||||||
|
local local_path=$2
|
||||||
|
smbclient --use-kerberos=required -N "$REGISTRATION_SHARE" \
|
||||||
|
-c "get ${remote_name} ${local_path}" >/dev/null
|
||||||
|
}
|
||||||
|
|
||||||
|
smb_put() {
|
||||||
|
local local_path=$1
|
||||||
|
local remote_name=$2
|
||||||
|
smbclient --use-kerberos=required -N "$REGISTRATION_SHARE" \
|
||||||
|
-c "put ${local_path} ${remote_name}" >/dev/null
|
||||||
|
}
|
||||||
|
|
||||||
|
install_rustdesk() {
|
||||||
|
local installer_path="${STATE_ROOT}/rustdesk-${CLIENT_VERSION}-x86_64.deb"
|
||||||
|
local installed_version=''
|
||||||
|
if command -v rustdesk >/dev/null 2>&1; then
|
||||||
|
installed_version=$(rustdesk --version 2>/dev/null | head -n 1 || true)
|
||||||
|
fi
|
||||||
|
|
||||||
|
if [[ $installed_version != *"${CLIENT_VERSION}"* ]]; then
|
||||||
|
curl --fail --location --proto '=https' --tlsv1.2 \
|
||||||
|
--output "$installer_path" "$DOWNLOAD_URI"
|
||||||
|
local actual_hash
|
||||||
|
actual_hash=$(sha256sum "$installer_path" | awk '{ print toupper($1) }')
|
||||||
|
[[ $actual_hash == "$EXPECTED_SHA256" ]] || fail 'RustDesk package SHA-256 verification failed.'
|
||||||
|
|
||||||
|
if command -v apt-get >/dev/null 2>&1; then
|
||||||
|
dpkg -i "$installer_path" || apt_get_with_retry install -f -y
|
||||||
|
else
|
||||||
|
fail 'The pinned RustDesk package is currently provided as a Debian package only.'
|
||||||
|
fi
|
||||||
|
fi
|
||||||
|
|
||||||
|
need_command rustdesk
|
||||||
|
systemctl enable rustdesk
|
||||||
|
}
|
||||||
|
|
||||||
|
read_server_configuration() {
|
||||||
|
local configuration_path="${STATE_ROOT}/rustdesk-client.json"
|
||||||
|
smb_get 'rustdesk-client.json' "$configuration_path"
|
||||||
|
|
||||||
|
RUSTDESK_SERVER_ADDRESS=$(python3 - "$configuration_path" <<'PY'
|
||||||
|
import json
|
||||||
|
import sys
|
||||||
|
with open(sys.argv[1], encoding='utf-8') as source:
|
||||||
|
value = json.load(source)
|
||||||
|
address = value.get('ServerAddress', '')
|
||||||
|
key = value.get('ServerPublicKey', '')
|
||||||
|
if not isinstance(address, str) or not isinstance(key, str) or not address or not key:
|
||||||
|
raise SystemExit('The controller RustDesk configuration is incomplete.')
|
||||||
|
print(address)
|
||||||
|
PY
|
||||||
|
)
|
||||||
|
RUSTDESK_SERVER_PUBLIC_KEY=$(python3 - "$configuration_path" <<'PY'
|
||||||
|
import json
|
||||||
|
import sys
|
||||||
|
with open(sys.argv[1], encoding='utf-8') as source:
|
||||||
|
print(json.load(source)['ServerPublicKey'])
|
||||||
|
PY
|
||||||
|
)
|
||||||
|
}
|
||||||
|
|
||||||
|
configure_rustdesk() {
|
||||||
|
local configuration
|
||||||
|
configuration=$(cat <<EOF
|
||||||
|
rendezvous_server = '${RUSTDESK_SERVER_ADDRESS}:21116'
|
||||||
|
nat_type = 1
|
||||||
|
serial = 0
|
||||||
|
|
||||||
|
[options]
|
||||||
|
custom-rendezvous-server = '${RUSTDESK_SERVER_ADDRESS}:21116'
|
||||||
|
relay-server = '${RUSTDESK_SERVER_ADDRESS}:21117'
|
||||||
|
key = '${RUSTDESK_SERVER_PUBLIC_KEY}'
|
||||||
|
verification-method = 'use-permanent-password'
|
||||||
|
approve-mode = 'password'
|
||||||
|
EOF
|
||||||
|
)
|
||||||
|
|
||||||
|
# The service starts as root but RustDesk hands its graphical server to the
|
||||||
|
# LightDM session account. Configure both profiles; writing only root's
|
||||||
|
# profile leaves the greeter-side server using a temporary password.
|
||||||
|
install -d -o root -g root -m 700 /root/.config/rustdesk /etc/rustdesk
|
||||||
|
printf '%s\n' "$configuration" | install -o root -g root -m 600 /dev/stdin \
|
||||||
|
/root/.config/rustdesk/RustDesk2.toml
|
||||||
|
printf '%s\n' "$configuration" | install -o root -g root -m 644 /dev/stdin \
|
||||||
|
/etc/rustdesk/RustDesk2.toml
|
||||||
|
if id lightdm >/dev/null 2>&1; then
|
||||||
|
install -d -o lightdm -g lightdm -m 700 /var/lib/lightdm/.config/rustdesk
|
||||||
|
printf '%s\n' "$configuration" | install -o lightdm -g lightdm -m 600 /dev/stdin \
|
||||||
|
/var/lib/lightdm/.config/rustdesk/RustDesk2.toml
|
||||||
|
fi
|
||||||
|
|
||||||
|
systemctl restart rustdesk
|
||||||
|
systemctl is-active --quiet rustdesk || fail 'The RustDesk service did not start.'
|
||||||
|
wait_for_rustdesk_server
|
||||||
|
}
|
||||||
|
|
||||||
|
configure_x11_login_screen() {
|
||||||
|
local display_manager=''
|
||||||
|
local configuration_changed=false
|
||||||
|
local configuration_path=''
|
||||||
|
local temporary_configuration=''
|
||||||
|
|
||||||
|
if [[ -L /etc/systemd/system/display-manager.service ]]; then
|
||||||
|
display_manager=$(basename "$(readlink -f /etc/systemd/system/display-manager.service)")
|
||||||
|
fi
|
||||||
|
|
||||||
|
case "$display_manager" in
|
||||||
|
gdm3.service|gdm.service)
|
||||||
|
# Ubuntu exposes the unit as gdm.service on some releases while
|
||||||
|
# the package still reads /etc/gdm3/custom.conf. Prefer the
|
||||||
|
# distribution-specific directory instead of inferring it only
|
||||||
|
# from the unit name.
|
||||||
|
if [[ -d /etc/gdm3 || -f /etc/gdm3/custom.conf ]]; then
|
||||||
|
configuration_path='/etc/gdm3/custom.conf'
|
||||||
|
else
|
||||||
|
configuration_path='/etc/gdm/custom.conf'
|
||||||
|
fi
|
||||||
|
install -d -o root -g root -m 755 "$(dirname "$configuration_path")"
|
||||||
|
[[ -f $configuration_path ]] || printf '[daemon]\n' >"$configuration_path"
|
||||||
|
temporary_configuration=$(mktemp)
|
||||||
|
python3 - "$configuration_path" "$temporary_configuration" <<'PY'
|
||||||
|
import re
|
||||||
|
import sys
|
||||||
|
from pathlib import Path
|
||||||
|
|
||||||
|
source = Path(sys.argv[1])
|
||||||
|
destination = Path(sys.argv[2])
|
||||||
|
lines = source.read_text(encoding='utf-8').splitlines()
|
||||||
|
daemon_start = None
|
||||||
|
daemon_end = len(lines)
|
||||||
|
for index, line in enumerate(lines):
|
||||||
|
if re.match(r'^\s*\[daemon\]\s*$', line, re.IGNORECASE):
|
||||||
|
daemon_start = index
|
||||||
|
continue
|
||||||
|
if daemon_start is not None and index > daemon_start and re.match(r'^\s*\[[^]]+\]\s*$', line):
|
||||||
|
daemon_end = index
|
||||||
|
break
|
||||||
|
|
||||||
|
if daemon_start is None:
|
||||||
|
if lines and lines[-1]:
|
||||||
|
lines.append('')
|
||||||
|
lines.extend(['[daemon]', 'WaylandEnable=false'])
|
||||||
|
else:
|
||||||
|
setting = re.compile(r'^\s*[#;]?\s*WaylandEnable\s*=.*$', re.IGNORECASE)
|
||||||
|
for index in range(daemon_start + 1, daemon_end):
|
||||||
|
if setting.match(lines[index]):
|
||||||
|
lines[index] = 'WaylandEnable=false'
|
||||||
|
break
|
||||||
|
else:
|
||||||
|
lines.insert(daemon_end, 'WaylandEnable=false')
|
||||||
|
|
||||||
|
destination.write_text('\n'.join(lines) + '\n', encoding='utf-8')
|
||||||
|
PY
|
||||||
|
if ! cmp -s "$temporary_configuration" "$configuration_path"; then
|
||||||
|
install -o root -g root -m 644 "$temporary_configuration" "$configuration_path"
|
||||||
|
configuration_changed=true
|
||||||
|
fi
|
||||||
|
rm -f "$temporary_configuration"
|
||||||
|
;;
|
||||||
|
sddm.service)
|
||||||
|
configuration_path='/etc/sddm.conf.d/91-sgu-rustdesk-x11.conf'
|
||||||
|
install -d -o root -g root -m 755 "$(dirname "$configuration_path")"
|
||||||
|
temporary_configuration=$(mktemp)
|
||||||
|
printf '%s\n' '[General]' 'DisplayServer=x11' >"$temporary_configuration"
|
||||||
|
if ! cmp -s "$temporary_configuration" "$configuration_path"; then
|
||||||
|
install -o root -g root -m 644 "$temporary_configuration" "$configuration_path"
|
||||||
|
configuration_changed=true
|
||||||
|
fi
|
||||||
|
rm -f "$temporary_configuration"
|
||||||
|
;;
|
||||||
|
lightdm.service)
|
||||||
|
# LightDM's greeter already runs on X11, which RustDesk supports.
|
||||||
|
;;
|
||||||
|
*)
|
||||||
|
printf 'WARNING: Could not identify a supported display manager; RustDesk login-screen access may require X11 configuration.\n' >&2
|
||||||
|
;;
|
||||||
|
esac
|
||||||
|
|
||||||
|
if [[ $configuration_changed == true ]]; then
|
||||||
|
printf 'RustDesk login-screen support was configured for X11; reboot after enrollment to activate it.\n'
|
||||||
|
fi
|
||||||
|
}
|
||||||
|
|
||||||
|
wait_for_rustdesk_server() {
|
||||||
|
local attempt
|
||||||
|
local candidate_id
|
||||||
|
|
||||||
|
# `systemctl is-active` only confirms that the launcher is alive. On Linux
|
||||||
|
# it still needs to start the `--server` process for the greeter account.
|
||||||
|
# Calling `rustdesk --password` during that short window returns successfully
|
||||||
|
# but does not persist a password for the remote-access process.
|
||||||
|
for attempt in $(seq 1 20); do
|
||||||
|
if systemctl is-active --quiet rustdesk \
|
||||||
|
&& pgrep -f '/usr/share/rustdesk/rustdesk --server' >/dev/null 2>&1; then
|
||||||
|
candidate_id=$(rustdesk --get-id 2>/dev/null | tail -n 1 | tr -d '[:space:]')
|
||||||
|
if [[ $candidate_id =~ ^[0-9]+$ ]]; then
|
||||||
|
RUSTDESK_ID=$candidate_id
|
||||||
|
return
|
||||||
|
fi
|
||||||
|
fi
|
||||||
|
sleep 1
|
||||||
|
done
|
||||||
|
|
||||||
|
fail 'The RustDesk greeter-side server did not become ready within 20 seconds.'
|
||||||
|
}
|
||||||
|
|
||||||
|
set_access_password() {
|
||||||
|
local secret_path="${STATE_ROOT}/access.secret"
|
||||||
|
if [[ -r $secret_path ]] && [[ $(wc -c <"$secret_path") -le 32 ]]; then
|
||||||
|
ACCESS_PASSWORD=$(<"$secret_path")
|
||||||
|
else
|
||||||
|
# RustDesk's permanent-password UI is reliable with a short, printable
|
||||||
|
# credential. Earlier Linux enrollment generated 48 hexadecimal
|
||||||
|
# characters; rotate that legacy value to a 24-character password.
|
||||||
|
ACCESS_PASSWORD="Sgu-$(openssl rand -hex 10)"
|
||||||
|
umask 077
|
||||||
|
printf '%s' "$ACCESS_PASSWORD" >"$secret_path"
|
||||||
|
chmod 600 "$secret_path"
|
||||||
|
fi
|
||||||
|
|
||||||
|
local password_result
|
||||||
|
wait_for_rustdesk_server
|
||||||
|
password_result=$(rustdesk --password "$ACCESS_PASSWORD" 2>&1) \
|
||||||
|
|| fail "RustDesk rejected the permanent password update: $password_result"
|
||||||
|
[[ $password_result == *Done!* ]] \
|
||||||
|
|| fail "RustDesk did not acknowledge the permanent password update: $password_result"
|
||||||
|
rustdesk --option verification-method use-permanent-password >/dev/null
|
||||||
|
rustdesk --option approve-mode password >/dev/null
|
||||||
|
systemctl restart rustdesk
|
||||||
|
systemctl is-active --quiet rustdesk || fail 'The RustDesk service did not restart after setting its permanent password.'
|
||||||
|
wait_for_rustdesk_server
|
||||||
|
}
|
||||||
|
|
||||||
|
register_with_controller() {
|
||||||
|
local certificate_path="${STATE_ROOT}/registration-public.cer"
|
||||||
|
local public_key_path="${STATE_ROOT}/registration-public.pem"
|
||||||
|
local request_path="${STATE_ROOT}/registration.request"
|
||||||
|
local encrypted_request_path="${STATE_ROOT}/registration.request.enc"
|
||||||
|
local result_path="${STATE_ROOT}/registration.result.json"
|
||||||
|
local request_id
|
||||||
|
request_id=$(cat /proc/sys/kernel/random/uuid)
|
||||||
|
local computer_name
|
||||||
|
computer_name=$(hostname -s | tr '[:lower:]' '[:upper:]')
|
||||||
|
[[ $computer_name =~ ^[A-Z0-9][A-Z0-9-]{0,62}$ ]] || fail 'The Linux computer name is not valid for RustDesk inventory.'
|
||||||
|
|
||||||
|
smb_get 'registration-public.cer' "$certificate_path"
|
||||||
|
openssl x509 -inform DER -in "$certificate_path" -pubkey -noout >"$public_key_path"
|
||||||
|
chmod 600 "$public_key_path"
|
||||||
|
|
||||||
|
# AccessPassword is hexadecimal and the other values are constrained, so
|
||||||
|
# this compact JSON is safe to construct without echoing sensitive data.
|
||||||
|
printf '{"ComputerName":"%s","RustDeskId":"%s","AccessPassword":"%s","RequestId":"%s"}' \
|
||||||
|
"$computer_name" "$RUSTDESK_ID" "$ACCESS_PASSWORD" "$request_id" >"$request_path"
|
||||||
|
openssl pkeyutl -encrypt -pubin -inkey "$public_key_path" \
|
||||||
|
-pkeyopt rsa_padding_mode:oaep -pkeyopt rsa_oaep_md:sha256 \
|
||||||
|
-in "$request_path" -out "$encrypted_request_path"
|
||||||
|
chmod 600 "$request_path" "$encrypted_request_path"
|
||||||
|
|
||||||
|
local remote_request="${computer_name}-${request_id}.request"
|
||||||
|
smb_put "$encrypted_request_path" "Requests/${remote_request}"
|
||||||
|
|
||||||
|
local attempt=0
|
||||||
|
while ((attempt < 18)); do
|
||||||
|
rm -f -- "$result_path"
|
||||||
|
if smb_get "Requests/${request_id}.result.json" "$result_path" 2>/dev/null; then
|
||||||
|
python3 - "$result_path" "$computer_name" "$RUSTDESK_ID" <<'PY'
|
||||||
|
import json
|
||||||
|
import sys
|
||||||
|
with open(sys.argv[1], encoding='utf-8') as source:
|
||||||
|
result = json.load(source)
|
||||||
|
if result.get('Status') != 'Registered':
|
||||||
|
raise SystemExit(result.get('Error', 'The controller rejected the RustDesk registration.'))
|
||||||
|
if result.get('ComputerName') != sys.argv[2] or result.get('RustDeskId') != sys.argv[3]:
|
||||||
|
raise SystemExit('The controller response did not match this computer or RustDesk ID.')
|
||||||
|
PY
|
||||||
|
rm -f -- "$request_path" "$encrypted_request_path" "$public_key_path" "$certificate_path" "$result_path"
|
||||||
|
return
|
||||||
|
fi
|
||||||
|
sleep 5
|
||||||
|
((attempt+=1))
|
||||||
|
done
|
||||||
|
fail 'RustDesk was configured locally, but the domain controller did not confirm inventory registration within 90 seconds.'
|
||||||
|
}
|
||||||
|
|
||||||
|
install -d -o root -g root -m 700 "$STATE_ROOT"
|
||||||
|
trap 'if [[ -n ${KRB5CCNAME:-} ]]; then rm -f -- "${KRB5CCNAME#FILE:}"; fi' EXIT
|
||||||
|
install_prerequisites
|
||||||
|
resolve_registration_share
|
||||||
|
initialize_machine_kerberos
|
||||||
|
install_rustdesk
|
||||||
|
read_server_configuration
|
||||||
|
configure_x11_login_screen
|
||||||
|
configure_rustdesk
|
||||||
|
set_access_password
|
||||||
|
register_with_controller
|
||||||
|
|
||||||
|
device_path="${STATE_ROOT}/device.json"
|
||||||
|
printf '{"ComputerName":"%s","RustDeskId":"%s","ServerAddress":"%s","ConfiguredAt":"%s"}\n' \
|
||||||
|
"$(hostname -s | tr '[:lower:]' '[:upper:]')" "$RUSTDESK_ID" "$RUSTDESK_SERVER_ADDRESS" \
|
||||||
|
"$(date --iso-8601=seconds)" >"$device_path"
|
||||||
|
chmod 600 "$device_path"
|
||||||
|
|
||||||
|
printf 'RustDesk enrollment completed. ID: %s\n' "$RUSTDESK_ID"
|
||||||
@@ -0,0 +1,356 @@
|
|||||||
|
[CmdletBinding(SupportsShouldProcess)]
|
||||||
|
param(
|
||||||
|
[Parameter(Mandatory)]
|
||||||
|
[ValidatePattern('^[A-Za-z0-9][A-Za-z0-9.-]*$')]
|
||||||
|
[string]$ServerAddress,
|
||||||
|
|
||||||
|
[Parameter(Mandatory)]
|
||||||
|
[ValidatePattern('^[A-Za-z0-9+/=]+$')]
|
||||||
|
[string]$ServerPublicKey,
|
||||||
|
|
||||||
|
[securestring]$AccessPassword,
|
||||||
|
[string]$InstallRoot = "$env:ProgramFiles\RustDesk",
|
||||||
|
[string]$StateRoot = "$env:ProgramData\SGU\RustDesk\Client",
|
||||||
|
[string]$ClientVersion = '1.4.9',
|
||||||
|
[uri]$DownloadUri = 'https://github.com/rustdesk/rustdesk/releases/download/1.4.9/rustdesk-1.4.9-x86_64.msi',
|
||||||
|
[ValidatePattern('^[A-Fa-f0-9]{64}$')]
|
||||||
|
[string]$ExpectedSha256 = 'C87D2F4CEF2A5ACD6003B6507DCFBF5D5168A256DB082CD90B54D35193224AAA'
|
||||||
|
)
|
||||||
|
|
||||||
|
$ErrorActionPreference = 'Stop'
|
||||||
|
$ProgressPreference = 'SilentlyContinue'
|
||||||
|
$downloadRoot = Join-Path $env:ProgramData 'SGU\RustDesk\Downloads'
|
||||||
|
$installerPath = Join-Path $downloadRoot "rustdesk-$ClientVersion-x86_64.msi"
|
||||||
|
$installerLogPath = Join-Path $downloadRoot "rustdesk-$ClientVersion-install.log"
|
||||||
|
$secretPath = Join-Path $StateRoot 'access.secret'
|
||||||
|
$devicePath = Join-Path $StateRoot 'device.json'
|
||||||
|
|
||||||
|
function Assert-Administrator {
|
||||||
|
$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.'
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
function Initialize-DataProtection {
|
||||||
|
if (-not ('SguRustDeskDataProtection' -as [type])) {
|
||||||
|
Add-Type -TypeDefinition @'
|
||||||
|
using System;
|
||||||
|
using System.ComponentModel;
|
||||||
|
using System.Runtime.InteropServices;
|
||||||
|
|
||||||
|
public static class SguRustDeskDataProtection {
|
||||||
|
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
|
||||||
|
private struct DataBlob { public int cbData; public IntPtr pbData; }
|
||||||
|
|
||||||
|
[DllImport("crypt32.dll", SetLastError = true, CharSet = CharSet.Unicode)]
|
||||||
|
private static extern bool CryptProtectData(ref DataBlob input, string description,
|
||||||
|
IntPtr optionalEntropy, IntPtr reserved, IntPtr prompt, int flags, out DataBlob output);
|
||||||
|
|
||||||
|
[DllImport("crypt32.dll", SetLastError = true, CharSet = CharSet.Unicode)]
|
||||||
|
private static extern bool CryptUnprotectData(ref DataBlob input, IntPtr description,
|
||||||
|
IntPtr optionalEntropy, IntPtr reserved, IntPtr prompt, int flags, out DataBlob output);
|
||||||
|
|
||||||
|
[DllImport("kernel32.dll", SetLastError = true)]
|
||||||
|
private static extern IntPtr LocalFree(IntPtr memory);
|
||||||
|
|
||||||
|
private const int CryptProtectLocalMachine = 0x4;
|
||||||
|
|
||||||
|
private static DataBlob ToBlob(byte[] value) {
|
||||||
|
var blob = new DataBlob { cbData = value.Length, pbData = IntPtr.Zero };
|
||||||
|
if (value.Length > 0) {
|
||||||
|
blob.pbData = Marshal.AllocHGlobal(value.Length);
|
||||||
|
Marshal.Copy(value, 0, blob.pbData, value.Length);
|
||||||
|
}
|
||||||
|
return blob;
|
||||||
|
}
|
||||||
|
|
||||||
|
private static byte[] FromBlob(DataBlob blob) {
|
||||||
|
var value = new byte[blob.cbData];
|
||||||
|
if (blob.cbData > 0) Marshal.Copy(blob.pbData, value, 0, blob.cbData);
|
||||||
|
return value;
|
||||||
|
}
|
||||||
|
|
||||||
|
public static byte[] Protect(byte[] value) {
|
||||||
|
var input = ToBlob(value); var output = new DataBlob();
|
||||||
|
try {
|
||||||
|
if (!CryptProtectData(ref input, null, IntPtr.Zero, IntPtr.Zero, IntPtr.Zero,
|
||||||
|
CryptProtectLocalMachine, out output)) {
|
||||||
|
throw new Win32Exception(Marshal.GetLastWin32Error());
|
||||||
|
}
|
||||||
|
return FromBlob(output);
|
||||||
|
} finally {
|
||||||
|
if (input.pbData != IntPtr.Zero) Marshal.FreeHGlobal(input.pbData);
|
||||||
|
if (output.pbData != IntPtr.Zero) LocalFree(output.pbData);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
public static byte[] Unprotect(byte[] value) {
|
||||||
|
var input = ToBlob(value); var output = new DataBlob();
|
||||||
|
try {
|
||||||
|
if (!CryptUnprotectData(ref input, IntPtr.Zero, IntPtr.Zero, IntPtr.Zero, IntPtr.Zero,
|
||||||
|
0, out output)) {
|
||||||
|
throw new Win32Exception(Marshal.GetLastWin32Error());
|
||||||
|
}
|
||||||
|
return FromBlob(output);
|
||||||
|
} finally {
|
||||||
|
if (input.pbData != IntPtr.Zero) Marshal.FreeHGlobal(input.pbData);
|
||||||
|
if (output.pbData != IntPtr.Zero) LocalFree(output.pbData);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
'@ -ErrorAction Stop
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
function Set-PrivateDirectoryAcl {
|
||||||
|
param([Parameter(Mandatory)][string]$Path)
|
||||||
|
|
||||||
|
New-Item -ItemType Directory -Path $Path -Force | Out-Null
|
||||||
|
$acl = New-Object Security.AccessControl.DirectorySecurity
|
||||||
|
$acl.SetAccessRuleProtection($true, $false)
|
||||||
|
$inheritance = [Security.AccessControl.InheritanceFlags]'ContainerInherit,ObjectInherit'
|
||||||
|
$allow = [Security.AccessControl.AccessControlType]::Allow
|
||||||
|
foreach ($sid in @('S-1-5-18', 'S-1-5-32-544')) {
|
||||||
|
$acl.AddAccessRule([Security.AccessControl.FileSystemAccessRule]::new(
|
||||||
|
[Security.Principal.SecurityIdentifier]::new($sid),
|
||||||
|
[Security.AccessControl.FileSystemRights]::FullControl,
|
||||||
|
$inheritance,
|
||||||
|
[Security.AccessControl.PropagationFlags]::None,
|
||||||
|
$allow))
|
||||||
|
}
|
||||||
|
Set-Acl -LiteralPath $Path -AclObject $acl
|
||||||
|
}
|
||||||
|
|
||||||
|
function ConvertTo-PlainText {
|
||||||
|
param([Parameter(Mandatory)][securestring]$SecureString)
|
||||||
|
|
||||||
|
$pointer = [Runtime.InteropServices.Marshal]::SecureStringToBSTR($SecureString)
|
||||||
|
try {
|
||||||
|
return [Runtime.InteropServices.Marshal]::PtrToStringBSTR($pointer)
|
||||||
|
}
|
||||||
|
finally {
|
||||||
|
[Runtime.InteropServices.Marshal]::ZeroFreeBSTR($pointer)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
function New-RandomAccessPassword {
|
||||||
|
$characters = 'ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz23456789!@#$%*+-_'.ToCharArray()
|
||||||
|
$bytes = New-Object byte[] 24
|
||||||
|
$rng = [Security.Cryptography.RandomNumberGenerator]::Create()
|
||||||
|
try {
|
||||||
|
$rng.GetBytes($bytes)
|
||||||
|
}
|
||||||
|
finally {
|
||||||
|
$rng.Dispose()
|
||||||
|
}
|
||||||
|
$value = -join ($bytes | ForEach-Object { $characters[$_ % $characters.Length] })
|
||||||
|
return (ConvertTo-SecureString -String $value -AsPlainText -Force)
|
||||||
|
}
|
||||||
|
|
||||||
|
function Save-AccessPassword {
|
||||||
|
param([Parameter(Mandatory)][securestring]$Password)
|
||||||
|
|
||||||
|
$plainText = ConvertTo-PlainText -SecureString $Password
|
||||||
|
try {
|
||||||
|
$cipherText = [SguRustDeskDataProtection]::Protect(
|
||||||
|
[Text.Encoding]::UTF8.GetBytes($plainText))
|
||||||
|
[IO.File]::WriteAllBytes($secretPath, $cipherText)
|
||||||
|
}
|
||||||
|
finally {
|
||||||
|
$plainText = $null
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
function Get-SavedAccessPassword {
|
||||||
|
if (-not (Test-Path -LiteralPath $secretPath -PathType Leaf)) {
|
||||||
|
return $null
|
||||||
|
}
|
||||||
|
$plainText = [Text.Encoding]::UTF8.GetString(
|
||||||
|
[SguRustDeskDataProtection]::Unprotect(
|
||||||
|
[IO.File]::ReadAllBytes($secretPath)))
|
||||||
|
try {
|
||||||
|
return (ConvertTo-SecureString -String $plainText -AsPlainText -Force)
|
||||||
|
}
|
||||||
|
finally {
|
||||||
|
$plainText = $null
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
function Assert-FileHash {
|
||||||
|
param(
|
||||||
|
[Parameter(Mandatory)][string]$Path,
|
||||||
|
[Parameter(Mandatory)][string]$ExpectedHash
|
||||||
|
)
|
||||||
|
|
||||||
|
$actualHash = (Get-FileHash -LiteralPath $Path -Algorithm SHA256).Hash
|
||||||
|
if (-not $actualHash.Equals($ExpectedHash, [StringComparison]::OrdinalIgnoreCase)) {
|
||||||
|
throw "SHA-256 verification failed for $Path."
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
function Test-TcpConnection {
|
||||||
|
param([Parameter(Mandatory)][string]$HostName, [Parameter(Mandatory)][int]$Port)
|
||||||
|
|
||||||
|
$client = [Net.Sockets.TcpClient]::new()
|
||||||
|
try {
|
||||||
|
$connect = $client.BeginConnect($HostName, $Port, $null, $null)
|
||||||
|
if (-not $connect.AsyncWaitHandle.WaitOne(5000)) {
|
||||||
|
return $false
|
||||||
|
}
|
||||||
|
$client.EndConnect($connect)
|
||||||
|
return $true
|
||||||
|
}
|
||||||
|
catch {
|
||||||
|
return $false
|
||||||
|
}
|
||||||
|
finally {
|
||||||
|
$client.Dispose()
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
Assert-Administrator
|
||||||
|
Initialize-DataProtection
|
||||||
|
if (-not $PSCmdlet.ShouldProcess($env:COMPUTERNAME, 'Install and configure the managed RustDesk client')) {
|
||||||
|
return
|
||||||
|
}
|
||||||
|
|
||||||
|
Set-PrivateDirectoryAcl -Path $StateRoot
|
||||||
|
New-Item -ItemType Directory -Path $downloadRoot -Force | Out-Null
|
||||||
|
$rustDeskExecutable = Join-Path $InstallRoot 'RustDesk.exe'
|
||||||
|
$installedVersion = if (Test-Path -LiteralPath $rustDeskExecutable -PathType Leaf) {
|
||||||
|
[string](Get-Item -LiteralPath $rustDeskExecutable).VersionInfo.ProductVersion
|
||||||
|
}
|
||||||
|
else {
|
||||||
|
''
|
||||||
|
}
|
||||||
|
if (-not $installedVersion.StartsWith($ClientVersion, [StringComparison]::OrdinalIgnoreCase)) {
|
||||||
|
if (-not (Test-Path -LiteralPath $installerPath -PathType Leaf) -or
|
||||||
|
(Get-FileHash -LiteralPath $installerPath -Algorithm SHA256).Hash -ne $ExpectedSha256) {
|
||||||
|
Invoke-WebRequest -Uri $DownloadUri -OutFile $installerPath -UseBasicParsing
|
||||||
|
}
|
||||||
|
Assert-FileHash -Path $installerPath -ExpectedHash $ExpectedSha256
|
||||||
|
# The vendor's MSI is the supported path for managed, silent Windows
|
||||||
|
# deployment. Unlike the GUI-oriented EXE it does not require an
|
||||||
|
# interactive desktop, which matters for startup/bootstrap execution.
|
||||||
|
$msiArguments = "/i `"$installerPath`" /qn /norestart " +
|
||||||
|
"INSTALLFOLDER=`"$InstallRoot`" CREATESTARTMENUSHORTCUTS=`"N`" " +
|
||||||
|
"CREATEDESKTOPSHORTCUTS=`"N`" INSTALLPRINTER=`"N`" /l*v `"$installerLogPath`""
|
||||||
|
$installer = Start-Process -FilePath (Join-Path $env:WINDIR 'System32\msiexec.exe') `
|
||||||
|
-ArgumentList $msiArguments -Wait -PassThru
|
||||||
|
if ($installer.ExitCode -notin @(0, 3010)) {
|
||||||
|
throw "RustDesk MSI installation failed with exit code $($installer.ExitCode). See $installerLogPath."
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
if (-not (Test-Path -LiteralPath $rustDeskExecutable -PathType Leaf)) {
|
||||||
|
throw "RustDesk installation did not create $rustDeskExecutable."
|
||||||
|
}
|
||||||
|
|
||||||
|
$rustDeskService = Get-Service -Name 'RustDesk' -ErrorAction SilentlyContinue
|
||||||
|
if (-not $rustDeskService) {
|
||||||
|
$serviceInstaller = Start-Process -FilePath $rustDeskExecutable -ArgumentList '--install-service' `
|
||||||
|
-Wait -PassThru
|
||||||
|
if ($serviceInstaller.ExitCode -ne 0) {
|
||||||
|
throw "RustDesk service installation failed with exit code $($serviceInstaller.ExitCode)."
|
||||||
|
}
|
||||||
|
Start-Sleep -Seconds 2
|
||||||
|
$rustDeskService = Get-Service -Name 'RustDesk' -ErrorAction SilentlyContinue
|
||||||
|
}
|
||||||
|
if (-not $rustDeskService) {
|
||||||
|
throw 'RustDesk did not register its Windows service.'
|
||||||
|
}
|
||||||
|
|
||||||
|
Set-Service -Name $rustDeskService.Name -StartupType Automatic
|
||||||
|
if ($rustDeskService.Status -ne 'Stopped') {
|
||||||
|
Stop-Service -Name $rustDeskService.Name -Force
|
||||||
|
$rustDeskService.WaitForStatus('Stopped', (New-TimeSpan -Seconds 20))
|
||||||
|
}
|
||||||
|
|
||||||
|
$rendezvousAddress = "$ServerAddress`:21116"
|
||||||
|
$relayAddress = "$ServerAddress`:21117"
|
||||||
|
$configuration = @"
|
||||||
|
rendezvous_server = '$rendezvousAddress'
|
||||||
|
nat_type = 1
|
||||||
|
serial = 0
|
||||||
|
|
||||||
|
[options]
|
||||||
|
custom-rendezvous-server = '$rendezvousAddress'
|
||||||
|
relay-server = '$relayAddress'
|
||||||
|
key = '$ServerPublicKey'
|
||||||
|
"@
|
||||||
|
$configurationPaths = @(
|
||||||
|
(Join-Path $env:ProgramData 'RustDesk\config\RustDesk2.toml'),
|
||||||
|
(Join-Path $env:WINDIR 'ServiceProfiles\LocalService\AppData\Roaming\RustDesk\config\RustDesk2.toml'),
|
||||||
|
(Join-Path $env:WINDIR 'System32\config\systemprofile\AppData\Roaming\RustDesk\config\RustDesk2.toml'),
|
||||||
|
(Join-Path $env:SystemDrive 'Users\Default\AppData\Roaming\RustDesk\config\RustDesk2.toml')
|
||||||
|
)
|
||||||
|
foreach ($configurationPath in $configurationPaths) {
|
||||||
|
New-Item -ItemType Directory -Path (Split-Path $configurationPath -Parent) -Force | Out-Null
|
||||||
|
[IO.File]::WriteAllText($configurationPath, $configuration, [Text.UTF8Encoding]::new($false))
|
||||||
|
}
|
||||||
|
|
||||||
|
$existingPassword = Get-SavedAccessPassword
|
||||||
|
if ($AccessPassword) {
|
||||||
|
$managedPassword = $AccessPassword
|
||||||
|
Save-AccessPassword -Password $managedPassword
|
||||||
|
$passwordWasGenerated = $false
|
||||||
|
}
|
||||||
|
elseif ($existingPassword) {
|
||||||
|
$managedPassword = $existingPassword
|
||||||
|
$passwordWasGenerated = $false
|
||||||
|
}
|
||||||
|
else {
|
||||||
|
$managedPassword = New-RandomAccessPassword
|
||||||
|
Save-AccessPassword -Password $managedPassword
|
||||||
|
$passwordWasGenerated = $true
|
||||||
|
}
|
||||||
|
|
||||||
|
Start-Service -Name $rustDeskService.Name
|
||||||
|
$rustDeskService = Get-Service -Name $rustDeskService.Name
|
||||||
|
$rustDeskService.WaitForStatus('Running', (New-TimeSpan -Seconds 20))
|
||||||
|
|
||||||
|
$plainPassword = ConvertTo-PlainText -SecureString $managedPassword
|
||||||
|
try {
|
||||||
|
# RustDesk on Windows only reliably treats its CLI output path as a command
|
||||||
|
# invocation when stdout is consumed. Without the pipeline it can attach
|
||||||
|
# to the GUI instance and leave a non-interactive bootstrap waiting.
|
||||||
|
$null = & $rustDeskExecutable --password $plainPassword | Out-String
|
||||||
|
if ($LASTEXITCODE -ne 0) {
|
||||||
|
throw "RustDesk could not set the managed access password (exit code $LASTEXITCODE)."
|
||||||
|
}
|
||||||
|
}
|
||||||
|
finally {
|
||||||
|
$plainPassword = $null
|
||||||
|
}
|
||||||
|
|
||||||
|
$rustDeskId = ((& $rustDeskExecutable --get-id | Out-String).Trim() -split "`r?`n" |
|
||||||
|
Select-Object -Last 1).Trim()
|
||||||
|
if ($rustDeskId -notmatch '^\d+$') {
|
||||||
|
throw "RustDesk returned an invalid device ID: $rustDeskId"
|
||||||
|
}
|
||||||
|
if (-not (Test-TcpConnection -HostName $ServerAddress -Port 21116)) {
|
||||||
|
throw "The RustDesk rendezvous server $rendezvousAddress is not reachable from this client."
|
||||||
|
}
|
||||||
|
|
||||||
|
$device = [ordered]@{
|
||||||
|
ComputerName = $env:COMPUTERNAME
|
||||||
|
RustDeskId = $rustDeskId
|
||||||
|
ServerAddress = $ServerAddress
|
||||||
|
ServerPublicKeySha256 = ([Security.Cryptography.SHA256]::Create().ComputeHash(
|
||||||
|
[Text.Encoding]::UTF8.GetBytes($ServerPublicKey)) | ForEach-Object ToString x2) -join ''
|
||||||
|
ConfiguredAt = (Get-Date).ToString('o')
|
||||||
|
}
|
||||||
|
[IO.File]::WriteAllText($devicePath, ($device | ConvertTo-Json), [Text.UTF8Encoding]::new($false))
|
||||||
|
|
||||||
|
[pscustomobject]@{
|
||||||
|
RustDeskId = $rustDeskId
|
||||||
|
ServerAddress = $ServerAddress
|
||||||
|
ServiceName = $rustDeskService.Name
|
||||||
|
ServiceStatus = (Get-Service -Name $rustDeskService.Name).Status.ToString()
|
||||||
|
RendezvousReachable = $true
|
||||||
|
AccessPassword = $managedPassword
|
||||||
|
AccessPasswordWasGenerated = $passwordWasGenerated
|
||||||
|
DevicePath = $devicePath
|
||||||
|
}
|
||||||
@@ -0,0 +1,128 @@
|
|||||||
|
[CmdletBinding(SupportsShouldProcess)]
|
||||||
|
param(
|
||||||
|
[Parameter(Mandatory)]
|
||||||
|
[ValidatePattern('^[A-Za-z0-9][A-Za-z0-9.-]*$')]
|
||||||
|
[string]$DomainName,
|
||||||
|
|
||||||
|
[Parameter(Mandatory)]
|
||||||
|
[ValidatePattern('^[A-Za-z0-9][A-Za-z0-9.-]*$')]
|
||||||
|
[string]$ServerAddress,
|
||||||
|
|
||||||
|
[Parameter(Mandatory)]
|
||||||
|
[ValidatePattern('^[A-Za-z0-9+/=]+$')]
|
||||||
|
[string]$ServerPublicKey,
|
||||||
|
|
||||||
|
[string]$RegistrationShareName = 'SGU-RustDesk-Enrollment$',
|
||||||
|
[string]$DataRoot = "$env:ProgramData\SGU\RustDesk\LinuxEnrollment",
|
||||||
|
[string]$ProcessorScriptPath = (Join-Path $PSScriptRoot 'Invoke-SguRustDeskLinuxRegistrationProcessor.ps1')
|
||||||
|
)
|
||||||
|
|
||||||
|
$ErrorActionPreference = 'Stop'
|
||||||
|
|
||||||
|
function Assert-Administrator {
|
||||||
|
$identity = [Security.Principal.WindowsIdentity]::GetCurrent()
|
||||||
|
$principal = [Security.Principal.WindowsPrincipal]::new($identity)
|
||||||
|
if (-not $principal.IsInRole([Security.Principal.WindowsBuiltInRole]::Administrator)) {
|
||||||
|
throw 'Only a local administrator can install Linux RustDesk enrollment.'
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
function Get-EnrollmentCertificate {
|
||||||
|
param([Parameter(Mandatory)][string]$FriendlyName)
|
||||||
|
|
||||||
|
$certificate = Get-ChildItem -Path Cert:\LocalMachine\My |
|
||||||
|
Where-Object FriendlyName -eq $FriendlyName |
|
||||||
|
Where-Object HasPrivateKey |
|
||||||
|
Select-Object -First 1
|
||||||
|
if (-not $certificate) {
|
||||||
|
$certificate = New-SelfSignedCertificate `
|
||||||
|
-Subject 'CN=SGU RustDesk Linux enrollment' `
|
||||||
|
-FriendlyName $FriendlyName `
|
||||||
|
-CertStoreLocation 'Cert:\LocalMachine\My' `
|
||||||
|
-KeyAlgorithm RSA `
|
||||||
|
-KeyLength 3072 `
|
||||||
|
-KeyUsage KeyEncipherment,DigitalSignature `
|
||||||
|
-NotAfter (Get-Date).AddYears(5)
|
||||||
|
}
|
||||||
|
return $certificate
|
||||||
|
}
|
||||||
|
|
||||||
|
function Set-EnrollmentDirectoryAcl {
|
||||||
|
param(
|
||||||
|
[Parameter(Mandatory)][string]$Path,
|
||||||
|
[Parameter(Mandatory)][string]$DomainNetbiosName
|
||||||
|
)
|
||||||
|
|
||||||
|
New-Item -ItemType Directory -Path $Path -Force | Out-Null
|
||||||
|
$arguments = @(
|
||||||
|
"`"$Path`"", '/inheritance:r',
|
||||||
|
'/grant:r', 'SYSTEM:(OI)(CI)(F)',
|
||||||
|
'BUILTIN\Administrators:(OI)(CI)(F)',
|
||||||
|
"$DomainNetbiosName\Domain Computers:(OI)(CI)(M)"
|
||||||
|
)
|
||||||
|
& icacls.exe @arguments | Out-Null
|
||||||
|
if ($LASTEXITCODE -ne 0) {
|
||||||
|
throw "Could not secure the Linux RustDesk enrollment directory $Path."
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
Assert-Administrator
|
||||||
|
Import-Module ActiveDirectory -ErrorAction Stop
|
||||||
|
if (-not (Test-Path -LiteralPath $ProcessorScriptPath -PathType Leaf)) {
|
||||||
|
throw "The Linux RustDesk registration processor is missing: $ProcessorScriptPath"
|
||||||
|
}
|
||||||
|
if (-not $PSCmdlet.ShouldProcess($env:COMPUTERNAME, 'Install the protected Linux RustDesk enrollment endpoint')) {
|
||||||
|
return
|
||||||
|
}
|
||||||
|
|
||||||
|
$domain = Get-ADDomain -Identity $DomainName
|
||||||
|
$publicRoot = Join-Path $DataRoot 'Public'
|
||||||
|
$requestsRoot = Join-Path $publicRoot 'Requests'
|
||||||
|
$archiveRoot = Join-Path $publicRoot 'Archive'
|
||||||
|
$rejectedRoot = Join-Path $publicRoot 'Rejected'
|
||||||
|
foreach ($path in @($DataRoot, $publicRoot, $requestsRoot, $archiveRoot, $rejectedRoot)) {
|
||||||
|
Set-EnrollmentDirectoryAcl -Path $path -DomainNetbiosName $domain.NetBIOSName
|
||||||
|
}
|
||||||
|
|
||||||
|
$certificate = Get-EnrollmentCertificate -FriendlyName 'SGU RustDesk Linux enrollment'
|
||||||
|
$publicCertificatePath = Join-Path $publicRoot 'registration-public.cer'
|
||||||
|
Export-Certificate -Cert $certificate -FilePath $publicCertificatePath -Force | Out-Null
|
||||||
|
$clientConfiguration = [ordered]@{
|
||||||
|
ServerAddress = $ServerAddress
|
||||||
|
ServerPublicKey = $ServerPublicKey
|
||||||
|
RegistrationShare = "\\$env:COMPUTERNAME\$RegistrationShareName"
|
||||||
|
UpdatedAt = (Get-Date).ToString('o')
|
||||||
|
}
|
||||||
|
[IO.File]::WriteAllText((Join-Path $publicRoot 'rustdesk-client.json'),
|
||||||
|
($clientConfiguration | ConvertTo-Json), [Text.UTF8Encoding]::new($false))
|
||||||
|
|
||||||
|
$share = Get-SmbShare -Name $RegistrationShareName -ErrorAction SilentlyContinue
|
||||||
|
if (-not $share) {
|
||||||
|
New-SmbShare -Name $RegistrationShareName -Path $publicRoot `
|
||||||
|
-FullAccess @('SYSTEM', 'BUILTIN\Administrators') `
|
||||||
|
-ChangeAccess "$($domain.NetBIOSName)\Domain Computers" | Out-Null
|
||||||
|
}
|
||||||
|
elseif ($share.Path -ne $publicRoot) {
|
||||||
|
throw "The existing SMB share $RegistrationShareName points to $($share.Path), not $publicRoot."
|
||||||
|
}
|
||||||
|
|
||||||
|
$installedProcessor = Join-Path $DataRoot 'Invoke-SguRustDeskLinuxRegistrationProcessor.ps1'
|
||||||
|
Copy-Item -LiteralPath $ProcessorScriptPath -Destination $installedProcessor -Force
|
||||||
|
$processorArguments = "-NoProfile -NonInteractive -ExecutionPolicy Bypass -File `"$installedProcessor`" -DataRoot `"$DataRoot`" -CertificateThumbprint $($certificate.Thumbprint)"
|
||||||
|
$action = New-ScheduledTaskAction -Execute (Join-Path $env:WINDIR 'System32\WindowsPowerShell\v1.0\powershell.exe') `
|
||||||
|
-Argument $processorArguments
|
||||||
|
$trigger = New-ScheduledTaskTrigger -Once -At (Get-Date).AddMinutes(1) `
|
||||||
|
-RepetitionInterval (New-TimeSpan -Minutes 1) -RepetitionDuration (New-TimeSpan -Days 3650)
|
||||||
|
$principal = New-ScheduledTaskPrincipal -UserId 'SYSTEM' -LogonType ServiceAccount -RunLevel Highest
|
||||||
|
Register-ScheduledTask -TaskName 'SGU-RustDesk-LinuxRegistration' -Action $action -Trigger $trigger `
|
||||||
|
-Principal $principal -Description 'Registers encrypted RustDesk credentials sent by domain-joined Linux computers.' -Force | Out-Null
|
||||||
|
|
||||||
|
New-NetFirewallRule -DisplayName 'SGU RustDesk Linux enrollment SMB' -Group 'SGU RustDesk' `
|
||||||
|
-Direction Inbound -Action Allow -Protocol TCP -LocalPort 445 -Profile Domain -ErrorAction SilentlyContinue | Out-Null
|
||||||
|
|
||||||
|
[pscustomobject]@{
|
||||||
|
RegistrationShare = "\\$env:COMPUTERNAME\$RegistrationShareName"
|
||||||
|
PublicCertificatePath = $publicCertificatePath
|
||||||
|
RegistrationTask = 'SGU-RustDesk-LinuxRegistration'
|
||||||
|
CertificateThumbprint = $certificate.Thumbprint
|
||||||
|
}
|
||||||
@@ -0,0 +1,241 @@
|
|||||||
|
[CmdletBinding(SupportsShouldProcess)]
|
||||||
|
param(
|
||||||
|
[Parameter(Mandatory)]
|
||||||
|
[ValidatePattern('^[A-Za-z0-9][A-Za-z0-9.-]*$')]
|
||||||
|
[string]$ServerAddress,
|
||||||
|
|
||||||
|
[string]$InstallRoot = "$env:ProgramFiles\SGU\RustDeskServer",
|
||||||
|
[string]$DataRoot = "$env:ProgramData\SGU\RustDesk\Server",
|
||||||
|
[ValidateNotNullOrEmpty()]
|
||||||
|
[string[]]$FirewallRemoteAddress = @('192.168.50.0/24'),
|
||||||
|
[uri]$DownloadUri = 'https://github.com/rustdesk/rustdesk-server/releases/download/1.1.16/rustdesk-server-windows-x86_64-unsigned.zip',
|
||||||
|
[ValidatePattern('^[A-Fa-f0-9]{64}$')]
|
||||||
|
[string]$ExpectedSha256 = 'B865A3A62FC8755B45480C508F1C4871C3338590408DDA8C58C7E9C373B7ADB0'
|
||||||
|
)
|
||||||
|
|
||||||
|
$ErrorActionPreference = 'Stop'
|
||||||
|
$ProgressPreference = 'SilentlyContinue'
|
||||||
|
$hbbsTaskName = 'SGU-RustDesk-hbbs'
|
||||||
|
$hbbrTaskName = 'SGU-RustDesk-hbbr'
|
||||||
|
$downloadRoot = Join-Path $env:ProgramData 'SGU\RustDesk\Downloads'
|
||||||
|
$archivePath = Join-Path $downloadRoot 'rustdesk-server-windows-x86_64-1.1.16.zip'
|
||||||
|
|
||||||
|
function Assert-Administrator {
|
||||||
|
$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.'
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
function Set-PrivateDirectoryAcl {
|
||||||
|
param([Parameter(Mandatory)][string]$Path)
|
||||||
|
|
||||||
|
New-Item -ItemType Directory -Path $Path -Force | Out-Null
|
||||||
|
$acl = New-Object Security.AccessControl.DirectorySecurity
|
||||||
|
$acl.SetAccessRuleProtection($true, $false)
|
||||||
|
$inheritance = [Security.AccessControl.InheritanceFlags]'ContainerInherit,ObjectInherit'
|
||||||
|
$allow = [Security.AccessControl.AccessControlType]::Allow
|
||||||
|
foreach ($sid in @('S-1-5-18', 'S-1-5-32-544')) {
|
||||||
|
$acl.AddAccessRule([Security.AccessControl.FileSystemAccessRule]::new(
|
||||||
|
[Security.Principal.SecurityIdentifier]::new($sid),
|
||||||
|
[Security.AccessControl.FileSystemRights]::FullControl,
|
||||||
|
$inheritance,
|
||||||
|
[Security.AccessControl.PropagationFlags]::None,
|
||||||
|
$allow))
|
||||||
|
}
|
||||||
|
Set-Acl -LiteralPath $Path -AclObject $acl
|
||||||
|
}
|
||||||
|
|
||||||
|
function Assert-FileHash {
|
||||||
|
param(
|
||||||
|
[Parameter(Mandatory)][string]$Path,
|
||||||
|
[Parameter(Mandatory)][string]$ExpectedHash
|
||||||
|
)
|
||||||
|
|
||||||
|
$actualHash = (Get-FileHash -LiteralPath $Path -Algorithm SHA256).Hash
|
||||||
|
if (-not $actualHash.Equals($ExpectedHash, [StringComparison]::OrdinalIgnoreCase)) {
|
||||||
|
throw "SHA-256 verification failed for $Path."
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
function Copy-IfDifferent {
|
||||||
|
param(
|
||||||
|
[Parameter(Mandatory)][string]$Source,
|
||||||
|
[Parameter(Mandatory)][string]$Destination
|
||||||
|
)
|
||||||
|
|
||||||
|
if (-not (Test-Path -LiteralPath $Destination -PathType Leaf) -or
|
||||||
|
(Get-FileHash -LiteralPath $Source -Algorithm SHA256).Hash -ne
|
||||||
|
(Get-FileHash -LiteralPath $Destination -Algorithm SHA256).Hash) {
|
||||||
|
Copy-Item -LiteralPath $Source -Destination $Destination -Force
|
||||||
|
return $true
|
||||||
|
}
|
||||||
|
return $false
|
||||||
|
}
|
||||||
|
|
||||||
|
function Set-RustDeskFirewallRule {
|
||||||
|
param(
|
||||||
|
[Parameter(Mandatory)][string]$Name,
|
||||||
|
[Parameter(Mandatory)][ValidateSet('TCP', 'UDP')][string]$Protocol,
|
||||||
|
[Parameter(Mandatory)][string]$LocalPort
|
||||||
|
)
|
||||||
|
|
||||||
|
$rule = Get-NetFirewallRule -DisplayName $Name -ErrorAction SilentlyContinue
|
||||||
|
if (-not $rule) {
|
||||||
|
$rule = New-NetFirewallRule -DisplayName $Name -Group 'SGU RustDesk' `
|
||||||
|
-Direction Inbound -Action Allow -Protocol $Protocol -LocalPort $LocalPort `
|
||||||
|
-RemoteAddress $FirewallRemoteAddress -Profile Domain -Enabled True
|
||||||
|
}
|
||||||
|
else {
|
||||||
|
$rule | Set-NetFirewallRule -Enabled True -Profile Domain -Action Allow | Out-Null
|
||||||
|
$rule | Get-NetFirewallPortFilter | Set-NetFirewallPortFilter `
|
||||||
|
-Protocol $Protocol -LocalPort $LocalPort | Out-Null
|
||||||
|
$rule | Get-NetFirewallAddressFilter | Set-NetFirewallAddressFilter `
|
||||||
|
-RemoteAddress $FirewallRemoteAddress | Out-Null
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
function Stop-RustDeskTasks {
|
||||||
|
foreach ($taskName in @($hbbsTaskName, $hbbrTaskName)) {
|
||||||
|
$task = Get-ScheduledTask -TaskName $taskName -ErrorAction SilentlyContinue
|
||||||
|
if ($task -and $task.State -eq 'Running') {
|
||||||
|
Stop-ScheduledTask -TaskName $taskName
|
||||||
|
}
|
||||||
|
}
|
||||||
|
Start-Sleep -Seconds 1
|
||||||
|
}
|
||||||
|
|
||||||
|
function Register-RustDeskServerTask {
|
||||||
|
param(
|
||||||
|
[Parameter(Mandatory)][string]$TaskName,
|
||||||
|
[Parameter(Mandatory)][string]$Executable,
|
||||||
|
[string]$Arguments
|
||||||
|
)
|
||||||
|
|
||||||
|
# New-ScheduledTaskAction rejects an empty -Argument value. hbbr has no
|
||||||
|
# command-line arguments, whereas hbbs needs the relay endpoint, so add
|
||||||
|
# the parameter only when it is meaningful.
|
||||||
|
$actionParameters = @{
|
||||||
|
Execute = $Executable
|
||||||
|
WorkingDirectory = $DataRoot
|
||||||
|
}
|
||||||
|
if (-not [string]::IsNullOrWhiteSpace($Arguments)) {
|
||||||
|
$actionParameters.Argument = $Arguments
|
||||||
|
}
|
||||||
|
$action = New-ScheduledTaskAction @actionParameters
|
||||||
|
$trigger = New-ScheduledTaskTrigger -AtStartup
|
||||||
|
$trigger.Delay = 'PT30S'
|
||||||
|
$settings = New-ScheduledTaskSettingsSet -StartWhenAvailable `
|
||||||
|
-AllowStartIfOnBatteries -DontStopIfGoingOnBatteries `
|
||||||
|
-ExecutionTimeLimit ([TimeSpan]::Zero) `
|
||||||
|
-RestartCount 3 -RestartInterval (New-TimeSpan -Minutes 1)
|
||||||
|
Register-ScheduledTask -TaskName $TaskName -Action $action -Trigger $trigger `
|
||||||
|
-Settings $settings -User 'SYSTEM' -RunLevel Highest -Force | Out-Null
|
||||||
|
$registeredTask = Get-ScheduledTask -TaskName $TaskName -ErrorAction Stop
|
||||||
|
if ($registeredTask.State -ne 'Running') {
|
||||||
|
Start-ScheduledTask -TaskName $TaskName
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
function Wait-ForRustDeskServer {
|
||||||
|
for ($attempt = 1; $attempt -le 30; $attempt++) {
|
||||||
|
$hbbsListening = [bool](Get-NetTCPConnection -LocalPort 21116 -State Listen `
|
||||||
|
-ErrorAction SilentlyContinue)
|
||||||
|
$hbbrListening = [bool](Get-NetTCPConnection -LocalPort 21117 -State Listen `
|
||||||
|
-ErrorAction SilentlyContinue)
|
||||||
|
$publicKeyReady = Test-Path -LiteralPath (Join-Path $DataRoot 'id_ed25519.pub') -PathType Leaf
|
||||||
|
if ($hbbsListening -and $hbbrListening -and $publicKeyReady) {
|
||||||
|
return
|
||||||
|
}
|
||||||
|
Start-Sleep -Seconds 2
|
||||||
|
}
|
||||||
|
throw 'RustDesk hbbs/hbbr did not become ready within 60 seconds.'
|
||||||
|
}
|
||||||
|
|
||||||
|
Assert-Administrator
|
||||||
|
if (-not $PSCmdlet.ShouldProcess($env:COMPUTERNAME, 'Install and configure the RustDesk OSS rendezvous and relay server')) {
|
||||||
|
return
|
||||||
|
}
|
||||||
|
|
||||||
|
Set-PrivateDirectoryAcl -Path $DataRoot
|
||||||
|
$managementRoot = Split-Path $DataRoot -Parent
|
||||||
|
Set-PrivateDirectoryAcl -Path $managementRoot
|
||||||
|
New-Item -ItemType Directory -Path $InstallRoot,$downloadRoot -Force | Out-Null
|
||||||
|
|
||||||
|
if (-not (Test-Path -LiteralPath $archivePath -PathType Leaf) -or
|
||||||
|
(Get-FileHash -LiteralPath $archivePath -Algorithm SHA256).Hash -ne $ExpectedSha256) {
|
||||||
|
Invoke-WebRequest -Uri $DownloadUri -OutFile $archivePath -UseBasicParsing
|
||||||
|
}
|
||||||
|
Assert-FileHash -Path $archivePath -ExpectedHash $ExpectedSha256
|
||||||
|
|
||||||
|
$stagingRoot = Join-Path $env:TEMP ('sgu-rustdesk-server-' + [Guid]::NewGuid().ToString('N'))
|
||||||
|
try {
|
||||||
|
Expand-Archive -LiteralPath $archivePath -DestinationPath $stagingRoot -Force
|
||||||
|
$payloadRoot = Join-Path $stagingRoot 'x86_64'
|
||||||
|
$sourceHbbs = Join-Path $payloadRoot 'hbbs.exe'
|
||||||
|
$sourceHbbr = Join-Path $payloadRoot 'hbbr.exe'
|
||||||
|
foreach ($required in @($sourceHbbs, $sourceHbbr)) {
|
||||||
|
if (-not (Test-Path -LiteralPath $required -PathType Leaf)) {
|
||||||
|
throw "The verified RustDesk archive is missing $required."
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
$targetHbbs = Join-Path $InstallRoot 'hbbs.exe'
|
||||||
|
$targetHbbr = Join-Path $InstallRoot 'hbbr.exe'
|
||||||
|
$requiresBinaryUpdate =
|
||||||
|
-not (Test-Path -LiteralPath $targetHbbs) -or
|
||||||
|
-not (Test-Path -LiteralPath $targetHbbr) -or
|
||||||
|
(Get-FileHash -LiteralPath $sourceHbbs -Algorithm SHA256).Hash -ne
|
||||||
|
(Get-FileHash -LiteralPath $targetHbbs -Algorithm SHA256).Hash -or
|
||||||
|
(Get-FileHash -LiteralPath $sourceHbbr -Algorithm SHA256).Hash -ne
|
||||||
|
(Get-FileHash -LiteralPath $targetHbbr -Algorithm SHA256).Hash
|
||||||
|
if ($requiresBinaryUpdate) {
|
||||||
|
Stop-RustDeskTasks
|
||||||
|
Copy-IfDifferent -Source $sourceHbbs -Destination $targetHbbs | Out-Null
|
||||||
|
Copy-IfDifferent -Source $sourceHbbr -Destination $targetHbbr | Out-Null
|
||||||
|
}
|
||||||
|
}
|
||||||
|
finally {
|
||||||
|
if (Test-Path -LiteralPath $stagingRoot) {
|
||||||
|
Remove-Item -LiteralPath $stagingRoot -Recurse -Force
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
Set-RustDeskFirewallRule -Name 'SGU RustDesk hbbs (TCP)' -Protocol TCP -LocalPort '21115-21116'
|
||||||
|
Set-RustDeskFirewallRule -Name 'SGU RustDesk hbbr (TCP)' -Protocol TCP -LocalPort '21117'
|
||||||
|
Set-RustDeskFirewallRule -Name 'SGU RustDesk hbbs (UDP)' -Protocol UDP -LocalPort '21116'
|
||||||
|
|
||||||
|
Register-RustDeskServerTask -TaskName $hbbrTaskName -Executable (Join-Path $InstallRoot 'hbbr.exe')
|
||||||
|
Register-RustDeskServerTask -TaskName $hbbsTaskName -Executable (Join-Path $InstallRoot 'hbbs.exe') `
|
||||||
|
-Arguments "-r $ServerAddress`:21117"
|
||||||
|
Wait-ForRustDeskServer
|
||||||
|
|
||||||
|
$publicKey = (Get-Content -LiteralPath (Join-Path $DataRoot 'id_ed25519.pub') -Raw).Trim()
|
||||||
|
if ([string]::IsNullOrWhiteSpace($publicKey)) {
|
||||||
|
throw 'RustDesk generated an empty public key.'
|
||||||
|
}
|
||||||
|
$statusPath = Join-Path (Split-Path $DataRoot -Parent) 'server.json'
|
||||||
|
$status = [ordered]@{
|
||||||
|
ServerAddress = $ServerAddress
|
||||||
|
PublicKey = $publicKey
|
||||||
|
PublicKeySha256 = ([Security.Cryptography.SHA256]::Create().ComputeHash(
|
||||||
|
[Text.Encoding]::UTF8.GetBytes($publicKey)) | ForEach-Object ToString x2) -join ''
|
||||||
|
HbbsTaskName = $hbbsTaskName
|
||||||
|
HbbrTaskName = $hbbrTaskName
|
||||||
|
HbbsTcpPort = 21116
|
||||||
|
HbbrTcpPort = 21117
|
||||||
|
InstalledAt = (Get-Date).ToString('o')
|
||||||
|
}
|
||||||
|
[IO.File]::WriteAllText($statusPath, ($status | ConvertTo-Json), [Text.UTF8Encoding]::new($false))
|
||||||
|
|
||||||
|
[pscustomobject]@{
|
||||||
|
ServerAddress = $ServerAddress
|
||||||
|
PublicKey = $publicKey
|
||||||
|
PublicKeySha256 = $status.PublicKeySha256
|
||||||
|
HbbsTask = (Get-ScheduledTask -TaskName $hbbsTaskName).State.ToString()
|
||||||
|
HbbrTask = (Get-ScheduledTask -TaskName $hbbrTaskName).State.ToString()
|
||||||
|
HbbsListening = [bool](Get-NetTCPConnection -LocalPort 21116 -State Listen -ErrorAction SilentlyContinue)
|
||||||
|
HbbrListening = [bool](Get-NetTCPConnection -LocalPort 21117 -State Listen -ErrorAction SilentlyContinue)
|
||||||
|
StatusPath = $statusPath
|
||||||
|
}
|
||||||
@@ -0,0 +1,100 @@
|
|||||||
|
[CmdletBinding(SupportsShouldProcess)]
|
||||||
|
param(
|
||||||
|
[string]$TargetOuDn = 'OU=Laboratorio,DC=lci,DC=lasalle,DC=mx',
|
||||||
|
[string]$GpoName = 'SGU - Windows client experience',
|
||||||
|
[string]$DomainController = $env:COMPUTERNAME
|
||||||
|
)
|
||||||
|
|
||||||
|
$ErrorActionPreference = 'Stop'
|
||||||
|
$identity = [Security.Principal.WindowsIdentity]::GetCurrent()
|
||||||
|
if (-not ([Security.Principal.WindowsPrincipal]::new($identity)).IsInRole(
|
||||||
|
[Security.Principal.WindowsBuiltInRole]::Administrator)) {
|
||||||
|
throw 'Run this script elevated on the domain controller.'
|
||||||
|
}
|
||||||
|
Import-Module ActiveDirectory -ErrorAction Stop
|
||||||
|
Import-Module GroupPolicy -ErrorAction Stop
|
||||||
|
|
||||||
|
$targetOu = Get-ADOrganizationalUnit -Identity $TargetOuDn -Server $DomainController
|
||||||
|
$domain = Get-ADDomain -Server $DomainController
|
||||||
|
if (-not $targetOu.DistinguishedName.EndsWith($domain.DistinguishedName,
|
||||||
|
[StringComparison]::OrdinalIgnoreCase)) {
|
||||||
|
throw 'The target OU is outside the domain.'
|
||||||
|
}
|
||||||
|
$domainName = $domain.DNSRoot
|
||||||
|
$gpo = Get-GPO -Name $GpoName -Domain $domainName -Server $DomainController -ErrorAction Stop
|
||||||
|
$links = @(Get-GPInheritance -Target $TargetOuDn -Domain $domainName -Server $DomainController).GpoLinks
|
||||||
|
if (-not @($links | Where-Object { $_.DisplayName -eq $GpoName -and
|
||||||
|
[string]$_.Enabled -in @('True','Yes') }).Count) {
|
||||||
|
throw "The existing GPO '$GpoName' must be linked and enabled on $TargetOuDn."
|
||||||
|
}
|
||||||
|
|
||||||
|
# The existing machine GPO also manages the credential tile. These startup
|
||||||
|
# scripts are a native Group Policy extension, not scheduled client tasks.
|
||||||
|
$scriptNames = @(
|
||||||
|
'Enable-SguWorkstationRemoteAccess.ps1',
|
||||||
|
'Enable-SguWorkstationAdministrators.ps1'
|
||||||
|
)
|
||||||
|
$startupRoot = Join-Path $env:WINDIR "SYSVOL\domain\Policies\{$($gpo.Id)}\Machine\Scripts"
|
||||||
|
$scriptsIniPath = Join-Path $startupRoot 'scripts.ini'
|
||||||
|
$startupScripts = @(
|
||||||
|
foreach ($scriptName in $scriptNames) {
|
||||||
|
$sourcePath = Join-Path $PSScriptRoot $scriptName
|
||||||
|
$startupPath = Join-Path $startupRoot "Startup\$scriptName"
|
||||||
|
$source = [IO.File]::ReadAllText($sourcePath)
|
||||||
|
[pscustomobject]@{
|
||||||
|
Name = $scriptName
|
||||||
|
Path = $startupPath
|
||||||
|
Source = $source
|
||||||
|
Changed = -not (Test-Path -LiteralPath $startupPath) -or
|
||||||
|
[IO.File]::ReadAllText($startupPath) -cne $source
|
||||||
|
}
|
||||||
|
}
|
||||||
|
)
|
||||||
|
$iniLines = @('[Startup]')
|
||||||
|
for ($index = 0; $index -lt $scriptNames.Count; $index++) {
|
||||||
|
$unc = "\\$domainName\SYSVOL\$domainName\Policies\{$($gpo.Id)}\Machine\Scripts\Startup\$($scriptNames[$index])"
|
||||||
|
$iniLines += "${index}CmdLine=powershell.exe"
|
||||||
|
$iniLines += "${index}Parameters=-NoProfile -NonInteractive -ExecutionPolicy Bypass -File `"$unc`""
|
||||||
|
}
|
||||||
|
$ini = ($iniLines -join "`r`n") + "`r`n"
|
||||||
|
$scriptChanged = @($startupScripts | Where-Object Changed).Count -gt 0
|
||||||
|
$iniChanged = -not (Test-Path -LiteralPath $scriptsIniPath) -or
|
||||||
|
[IO.File]::ReadAllText($scriptsIniPath) -cne $ini
|
||||||
|
|
||||||
|
if (($scriptChanged -or $iniChanged) -and
|
||||||
|
$PSCmdlet.ShouldProcess($startupRoot, 'Install computer startup script')) {
|
||||||
|
New-Item -ItemType Directory -Path (Join-Path $startupRoot 'Startup') -Force | Out-Null
|
||||||
|
foreach ($startupScript in $startupScripts) {
|
||||||
|
if ($startupScript.Changed) {
|
||||||
|
[IO.File]::WriteAllText($startupScript.Path, $startupScript.Source,
|
||||||
|
[Text.UTF8Encoding]::new($false))
|
||||||
|
}
|
||||||
|
}
|
||||||
|
[IO.File]::WriteAllText($scriptsIniPath, $ini, [Text.Encoding]::Unicode)
|
||||||
|
$gpoDn = "CN={$($gpo.Id)},CN=Policies,CN=System,$($domain.DistinguishedName)"
|
||||||
|
$adGpo = Get-ADObject -Identity $gpoDn -Server $DomainController `
|
||||||
|
-Properties gPCMachineExtensionNames,versionNumber
|
||||||
|
$extension = '[{42B5FAAE-6536-11D2-AE5A-0000F87571E3}{40B6664F-4972-11D1-A7CA-0000F87571E3}]'
|
||||||
|
$names = [string]$adGpo.gPCMachineExtensionNames
|
||||||
|
if ($names.IndexOf($extension, [StringComparison]::OrdinalIgnoreCase) -lt 0) {
|
||||||
|
Set-ADObject -Identity $gpoDn -Server $DomainController `
|
||||||
|
-Replace @{gPCMachineExtensionNames = "$names$extension"}
|
||||||
|
}
|
||||||
|
$gptPath = Join-Path (Split-Path (Split-Path $startupRoot -Parent) -Parent) 'GPT.ini'
|
||||||
|
$gpt = [IO.File]::ReadAllText($gptPath)
|
||||||
|
$gptVersion = [int]([regex]::Match($gpt, '(?m)^Version=(\d+)\r?$').Groups[1].Value)
|
||||||
|
$baseVersion = [Math]::Max($gptVersion, [int]$adGpo.versionNumber)
|
||||||
|
$nextVersion = ($baseVersion -band -65536) -bor (($baseVersion + 1) -band 65535)
|
||||||
|
[IO.File]::WriteAllText($gptPath,
|
||||||
|
[regex]::Replace($gpt, '(?m)^Version=\d+\r?$', "Version=$nextVersion"),
|
||||||
|
[Text.Encoding]::ASCII)
|
||||||
|
Set-ADObject -Identity $gpoDn -Server $DomainController -Replace @{versionNumber = $nextVersion}
|
||||||
|
}
|
||||||
|
|
||||||
|
[pscustomobject]@{
|
||||||
|
GpoName = $GpoName
|
||||||
|
GpoId = $gpo.Id
|
||||||
|
TargetOu = $TargetOuDn
|
||||||
|
StartupScripts = @($startupScripts.Path)
|
||||||
|
Changed = $scriptChanged -or $iniChanged
|
||||||
|
}
|
||||||
@@ -0,0 +1,17 @@
|
|||||||
|
[CmdletBinding()]
|
||||||
|
param([switch]$InstallTask)
|
||||||
|
$ErrorActionPreference='Stop'
|
||||||
|
# Compatibility entry point for cached WLAN startup registrations.
|
||||||
|
# The global SYSTEMCENTER GPO owns installation, repair and version selection.
|
||||||
|
$canonical=Get-ScheduledTask -TaskName 'LCI-ConfigMgr2509-ClientRegistration' -ErrorAction SilentlyContinue
|
||||||
|
if(-not $canonical -or -not $canonical.Settings.Enabled -or $canonical.Actions.Arguments -notmatch 'SYSTEMCENTER\.lci\.lasalle\.mx.+Ensure-CMCurrentClient\.ps1'){
|
||||||
|
Write-Warning 'Apply the global Configuration Manager policy with gpupdate /target:computer /force. The retired CED installer task is not recreated.'
|
||||||
|
return
|
||||||
|
}
|
||||||
|
foreach($name in 'CED Configuration Manager enrollment','CED Configuration Manager policy enrollment'){
|
||||||
|
$old=Get-ScheduledTask -TaskName $name -ErrorAction SilentlyContinue
|
||||||
|
if($old -and $old.Settings.Enabled -and $old.State -ne 'Running'){Disable-ScheduledTask -InputObject $old|Out-Null}
|
||||||
|
}
|
||||||
|
if($InstallTask -and -not(Get-Service CcmExec -ErrorAction SilentlyContinue)){
|
||||||
|
Start-ScheduledTask -InputObject $canonical
|
||||||
|
}
|
||||||
@@ -0,0 +1,87 @@
|
|||||||
|
[CmdletBinding()]
|
||||||
|
param(
|
||||||
|
[Parameter(Mandatory)][string]$InventoryPath,
|
||||||
|
[Parameter(Mandatory)][PSCredential]$Credential,
|
||||||
|
[string]$TargetOuDn = 'OU=Centro de Experiencia Digital,OU=Laboratorio,DC=lci,DC=lasalle,DC=mx',
|
||||||
|
[string]$DomainController = $env:COMPUTERNAME,
|
||||||
|
[string]$DnsServer = '',
|
||||||
|
[string]$FallbackDnsServer = '',
|
||||||
|
[switch]$InstallClient,
|
||||||
|
[switch]$MigrateWifi,
|
||||||
|
[switch]$RestartPendingInstall,
|
||||||
|
[string]$ClientSource = '\\sgu-dc02.lci.lasalle.mx\CEDClient$'
|
||||||
|
)
|
||||||
|
$ErrorActionPreference = 'Stop'
|
||||||
|
Import-Module ActiveDirectory
|
||||||
|
$domain = Get-ADDomain -Server $DomainController
|
||||||
|
Get-ADOrganizationalUnit -Identity $TargetOuDn -Server $DomainController | Out-Null
|
||||||
|
$allowed = @(Get-ADComputer -SearchBase $TargetOuDn -Filter 'Enabled -eq $true' -Server $DomainController)
|
||||||
|
$inventory = Get-Content -LiteralPath $InventoryPath -Raw | ConvertFrom-Json
|
||||||
|
$networkConfiguration=[IO.File]::ReadAllText((Join-Path $PSScriptRoot 'ced-network.json'))|ConvertFrom-Json
|
||||||
|
if(-not $DnsServer){$DnsServer=[string]$networkConfiguration.DnsServers[0]}
|
||||||
|
if(-not $FallbackDnsServer){$FallbackDnsServer=[string]$networkConfiguration.DnsServers[1]}
|
||||||
|
$options = New-PSSessionOption -OpenTimeout 10000 -OperationTimeout 180000
|
||||||
|
foreach ($item in $inventory) {
|
||||||
|
if ($item.WinRM -eq $false) { continue }
|
||||||
|
if ($item.Name -notin $allowed.Name) { throw "Inventory host outside approved OU: $($item.Name)" }
|
||||||
|
[Net.IPAddress]::Parse($item.IP) | Out-Null
|
||||||
|
$session = $null
|
||||||
|
try {
|
||||||
|
$address = $item.IP
|
||||||
|
# After migration the old DHCP address is stale. Prefer a reachable
|
||||||
|
# current AD/DNS hostname, then validate the actual remote identity.
|
||||||
|
$hostname = ($allowed | Where-Object Name -eq $item.Name).DNSHostName
|
||||||
|
if (-not $hostname) { $hostname = $item.Name+'.'+$domain.DNSRoot }
|
||||||
|
$probe = [Net.Sockets.TcpClient]::new()
|
||||||
|
try {
|
||||||
|
$pending = $probe.BeginConnect($hostname,5985,$null,$null)
|
||||||
|
if ($pending.AsyncWaitHandle.WaitOne(1000) -and $probe.Connected) { $address = $hostname }
|
||||||
|
} catch { } finally { $probe.Dispose() }
|
||||||
|
$session = New-PSSession -ComputerName $address -Credential $Credential -Authentication Negotiate -SessionOption $options
|
||||||
|
$identity = Invoke-Command -Session $session {
|
||||||
|
[pscustomobject]@{Name=$env:COMPUTERNAME;Domain=(Get-CimInstance Win32_ComputerSystem).Domain;Trusted=Test-ComputerSecureChannel}
|
||||||
|
}
|
||||||
|
if ($identity.Name -ine $item.Name -or $identity.Domain -ine $domain.DNSRoot -or -not $identity.Trusted) {
|
||||||
|
throw 'Remote identity/domain/secure-channel validation failed.'
|
||||||
|
}
|
||||||
|
$state = Invoke-Command -Session $session -ArgumentList $DnsServer,$domain.DNSRoot,$FallbackDnsServer {
|
||||||
|
param($dns,$suffix,$fallbackDns)
|
||||||
|
New-Item C:\ProgramData\LCI-Admin -ItemType Directory -Force | Out-Null
|
||||||
|
$backup = 'C:\ProgramData\LCI-Admin\CED-dns-before.json'
|
||||||
|
if (-not (Test-Path $backup)) {
|
||||||
|
Get-DnsClientServerAddress -AddressFamily IPv4 | Select-Object InterfaceAlias,InterfaceIndex,ServerAddresses |
|
||||||
|
ConvertTo-Json -Depth 3 | Set-Content -LiteralPath $backup
|
||||||
|
}
|
||||||
|
$wifi = @(Get-NetAdapter | Where-Object { $_.NdisPhysicalMedium -eq 9 -and $_.Status -eq 'Up' })
|
||||||
|
if ($wifi.Count -ne 1) { throw 'Expected one active Wi-Fi interface.' }
|
||||||
|
Set-DnsClientServerAddress -InterfaceIndex $wifi[0].InterfaceIndex -ServerAddresses @($dns,$fallbackDns)
|
||||||
|
Set-DnsClient -InterfaceIndex $wifi[0].InterfaceIndex -ConnectionSpecificSuffix $suffix -RegisterThisConnectionsAddress $true
|
||||||
|
Register-DnsClient
|
||||||
|
& gpupdate.exe /target:computer /force /wait:90 | Out-Null
|
||||||
|
if ($LASTEXITCODE) { throw "gpupdate failed: $LASTEXITCODE" }
|
||||||
|
[pscustomobject]@{Name=$env:COMPUTERNAME;WifiPolicyPresent=(netsh.exe wlan show profiles | Select-String 'Centro de Experiencia Digital').Count -gt 0;ClientPresent=[bool](Get-Service CcmExec -ErrorAction SilentlyContinue)}
|
||||||
|
}
|
||||||
|
if (-not $state.WifiPolicyPresent) { throw 'Native CED Wi-Fi policy was not applied.' }
|
||||||
|
if ($InstallClient -and -not $state.ClientPresent) {
|
||||||
|
Invoke-Command -Session $session {
|
||||||
|
$task=Get-ScheduledTask -TaskName 'LCI-ConfigMgr2509-ClientRegistration' -ErrorAction SilentlyContinue
|
||||||
|
if(-not $task -or -not $task.Settings.Enabled){throw 'Apply the global SYSTEMCENTER Configuration Manager GPO before requesting client installation.'}
|
||||||
|
Start-ScheduledTask -InputObject $task
|
||||||
|
}
|
||||||
|
}
|
||||||
|
if ($MigrateWifi) {
|
||||||
|
foreach ($file in 'Install-SguCedWifiMaintenance.ps1','Repair-SguCedWifi.ps1','Set-SguCedClientNetwork.ps1','ced-network.json') {
|
||||||
|
Copy-Item (Join-Path $PSScriptRoot $file) (Join-Path C:\ProgramData\LCI-Admin $file) -ToSession $session -Force
|
||||||
|
}
|
||||||
|
Invoke-Command -Session $session {
|
||||||
|
& powershell.exe -NoProfile -ExecutionPolicy Bypass -File C:\ProgramData\LCI-Admin\Install-SguCedWifiMaintenance.ps1
|
||||||
|
if ($LASTEXITCODE) { throw 'Wi-Fi maintenance task installation failed.' }
|
||||||
|
}
|
||||||
|
}
|
||||||
|
[pscustomobject]@{Name=$item.Name;IP=$item.IP;Prepared=$true;ClientPresent=$state.ClientPresent;InstallationRequested=[bool]$InstallClient;Error=$null}
|
||||||
|
} catch {
|
||||||
|
[pscustomobject]@{Name=$item.Name;IP=$item.IP;Prepared=$false;ClientPresent=$false;InstallationRequested=$false;Error=$_.Exception.Message}
|
||||||
|
} finally {
|
||||||
|
if ($session) { Remove-PSSession $session }
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -3,19 +3,61 @@
|
|||||||
param(
|
param(
|
||||||
[ipaddress]$DomainControllerIPv4Address,
|
[ipaddress]$DomainControllerIPv4Address,
|
||||||
[string]$NetworkInterfaceAlias,
|
[string]$NetworkInterfaceAlias,
|
||||||
|
[ipaddress]$ClientIPv4Address,
|
||||||
|
[ValidateRange(1, 32)]
|
||||||
|
[int]$ClientPrefixLength = 24,
|
||||||
[PSCredential]$DomainCredential,
|
[PSCredential]$DomainCredential,
|
||||||
[string]$DomainName = 'lci.lasalle.mx',
|
[string]$DomainName,
|
||||||
[string]$DomainNetbios = 'LCI',
|
[string]$DomainNetbios,
|
||||||
[string]$ComputerOuDn,
|
[string]$ComputerOuDn,
|
||||||
[string]$NewComputerName,
|
[string]$NewComputerName,
|
||||||
|
[ValidateSet('Auto', 'Windows10Legacy', 'Windows11Modern')]
|
||||||
|
[string]$CompatibilityProfile = 'Auto',
|
||||||
|
[ValidateSet('Direct', 'AzureP2S')]
|
||||||
|
[string]$ConnectivityMode = 'Direct',
|
||||||
|
[string]$VpnConnectionName = 'SGU Azure P2S',
|
||||||
|
[string]$VpnProfilePackagePath,
|
||||||
|
[string]$VpnClientCertificatePfxPath,
|
||||||
|
[securestring]$VpnClientCertificatePfxPassword,
|
||||||
|
[string]$VpnClientRootCertificatePath,
|
||||||
|
[string[]]$AzureNetworkPrefixes = @('10.77.0.0/16'),
|
||||||
|
[string]$FsLogixInstallerPath,
|
||||||
|
[switch]$PauseOnError,
|
||||||
[switch]$SkipRestart
|
[switch]$SkipRestart
|
||||||
)
|
)
|
||||||
|
|
||||||
$ErrorActionPreference = 'Stop'
|
$ErrorActionPreference = 'Stop'
|
||||||
$brokerRecordName = 'sgu-auth'
|
$brokerRecordName = 'sgu-auth'
|
||||||
$brokerDnsName = "$brokerRecordName.$DomainName"
|
|
||||||
$brokerEndpoint = "https://${brokerDnsName}:8443/v1/authenticate"
|
|
||||||
$temporaryRoot = Join-Path $env:ProgramData ("SGU\Bootstrap\Client-" + [Guid]::NewGuid().ToString('N'))
|
$temporaryRoot = Join-Path $env:ProgramData ("SGU\Bootstrap\Client-" + [Guid]::NewGuid().ToString('N'))
|
||||||
|
$bootstrapLogRoot = Join-Path $env:ProgramData 'SGU\Bootstrap\Client'
|
||||||
|
$bootstrapErrorLog = Join-Path $bootstrapLogRoot 'latest-error.log'
|
||||||
|
|
||||||
|
trap {
|
||||||
|
$failure = $_
|
||||||
|
$failureText = @(
|
||||||
|
"SGU client enrollment failed at $((Get-Date).ToString('s')).",
|
||||||
|
'',
|
||||||
|
$failure.Exception.Message,
|
||||||
|
'',
|
||||||
|
$failure.ScriptStackTrace
|
||||||
|
) -join [Environment]::NewLine
|
||||||
|
try {
|
||||||
|
New-Item -ItemType Directory -Path $bootstrapLogRoot -Force | Out-Null
|
||||||
|
[IO.File]::WriteAllText($bootstrapErrorLog, $failureText, [Text.UTF8Encoding]::new($false))
|
||||||
|
}
|
||||||
|
catch {
|
||||||
|
# Keep the original enrollment error when diagnostics cannot be written.
|
||||||
|
}
|
||||||
|
|
||||||
|
Write-Host ''
|
||||||
|
Write-Host 'SGU client enrollment did not complete.' -ForegroundColor Red
|
||||||
|
Write-Host $failure.Exception.Message -ForegroundColor Red
|
||||||
|
Write-Host "Diagnostic log: $bootstrapErrorLog" -ForegroundColor Yellow
|
||||||
|
if ($PauseOnError -and [Environment]::UserInteractive) {
|
||||||
|
Read-Host 'Press ENTER to close this window' | Out-Null
|
||||||
|
}
|
||||||
|
exit 1
|
||||||
|
}
|
||||||
|
|
||||||
function Assert-Administrator {
|
function Assert-Administrator {
|
||||||
$identity = [Security.Principal.WindowsIdentity]::GetCurrent()
|
$identity = [Security.Principal.WindowsIdentity]::GetCurrent()
|
||||||
@@ -44,42 +86,235 @@ function Assert-PackageManifest {
|
|||||||
throw "Bootstrap package integrity check failed: $($entry.Path)"
|
throw "Bootstrap package integrity check failed: $($entry.Path)"
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
return $manifest
|
||||||
}
|
}
|
||||||
|
|
||||||
function Resolve-ClientInterfaceAlias {
|
function Resolve-ClientInterfaceAlias {
|
||||||
param([string]$RequestedAlias)
|
param(
|
||||||
|
[string]$RequestedAlias,
|
||||||
|
[Parameter(Mandatory)][ipaddress]$DomainControllerAddress
|
||||||
|
)
|
||||||
|
|
||||||
if ($RequestedAlias) {
|
# IP interfaces include tunnel/PPP adapters that Get-NetAdapter can omit.
|
||||||
Get-NetAdapter -Name $RequestedAlias -ErrorAction Stop | Out-Null
|
$interfaces = @(Get-NetIPInterface -AddressFamily IPv4 | Where-Object {
|
||||||
return $RequestedAlias
|
$_.ConnectionState -eq 'Connected' -and
|
||||||
|
(-not $RequestedAlias -or $_.InterfaceAlias -eq $RequestedAlias)
|
||||||
|
})
|
||||||
|
$preferred = @(Find-NetRoute -RemoteIPAddress $DomainControllerAddress.IPAddressToString `
|
||||||
|
-ErrorAction SilentlyContinue | Where-Object { $_.PSObject.Properties['IPAddress'] })
|
||||||
|
$attempts = @()
|
||||||
|
$candidates = @(foreach ($interface in $interfaces) {
|
||||||
|
$addresses = @(Get-NetIPAddress -InterfaceIndex $interface.InterfaceIndex -AddressFamily IPv4 `
|
||||||
|
-ErrorAction SilentlyContinue | Where-Object {
|
||||||
|
$_.AddressState -eq 'Preferred' -and -not $_.SkipAsSource -and
|
||||||
|
$_.IPAddress -notmatch '^(0\.|127\.|169\.254\.)'
|
||||||
|
})
|
||||||
|
if ($addresses.Count -eq 0) {
|
||||||
|
$attempts += "$($interface.InterfaceAlias): no usable IPv4 address (check DHCP/static configuration)"
|
||||||
|
continue
|
||||||
|
}
|
||||||
|
$route = Get-NetRoute -InterfaceIndex $interface.InterfaceIndex -AddressFamily IPv4 `
|
||||||
|
-PolicyStore ActiveStore -ErrorAction SilentlyContinue | Where-Object {
|
||||||
|
$parts = $_.DestinationPrefix -split '/'
|
||||||
|
Test-IPv4AddressesSharePrefix -FirstAddress $DomainControllerAddress `
|
||||||
|
-SecondAddress ([ipaddress]$parts[0]) -PrefixLength ([int]$parts[1])
|
||||||
|
} | Sort-Object @{ Expression = { [int]($_.DestinationPrefix -split '/')[1] }; Descending = $true },
|
||||||
|
RouteMetric | Select-Object -First 1
|
||||||
|
if ($route) {
|
||||||
|
foreach ($address in $addresses) {
|
||||||
|
[pscustomobject]@{
|
||||||
|
InterfaceAlias = $interface.InterfaceAlias
|
||||||
|
InterfaceIndex = [int]$interface.InterfaceIndex
|
||||||
|
IPAddress = $address.IPAddress
|
||||||
|
NextHop = $route.NextHop
|
||||||
|
Preferred = @($preferred | Where-Object IPAddress -eq $address.IPAddress).Count -gt 0
|
||||||
|
PrefixLength = [int]($route.DestinationPrefix -split '/')[1]
|
||||||
|
Metric = [int]$route.RouteMetric + [int]$interface.InterfaceMetric
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
else { $attempts += "$($interface.InterfaceAlias): no route to $DomainControllerAddress" }
|
||||||
|
})
|
||||||
|
if ($interfaces.Count -eq 0) { $attempts += 'No matching connected IPv4 interface' }
|
||||||
|
foreach ($candidate in ($candidates | Sort-Object @{ Expression = { $_.Preferred }; Descending = $true },
|
||||||
|
@{ Expression = { $_.PrefixLength }; Descending = $true }, Metric, InterfaceIndex, IPAddress)) {
|
||||||
|
Write-Host "Checking $($candidate.InterfaceAlias) ($($candidate.IPAddress)) -> $DomainControllerAddress..."
|
||||||
|
if (Test-TcpPort -Address $DomainControllerAddress -Port 5985 -TimeoutMilliseconds 2000 `
|
||||||
|
-SourceAddress ([ipaddress]$candidate.IPAddress) -InterfaceIndex $candidate.InterfaceIndex) {
|
||||||
|
return $candidate
|
||||||
|
}
|
||||||
|
$attempts += "$($candidate.InterfaceAlias) [$($candidate.IPAddress), next hop $($candidate.NextHop)]: TCP 5985 unavailable"
|
||||||
|
}
|
||||||
|
throw "Cannot reach SGU server $DomainControllerAddress. $($attempts -join '; '). Check the LAN/VPN connection, DHCP or an administrator-assigned IP, routes and the server WinRM firewall. No client IP was changed."
|
||||||
|
}
|
||||||
|
|
||||||
|
function Test-IPv4AddressesSharePrefix {
|
||||||
|
param(
|
||||||
|
[Parameter(Mandatory)][ipaddress]$FirstAddress,
|
||||||
|
[Parameter(Mandatory)][ipaddress]$SecondAddress,
|
||||||
|
[Parameter(Mandatory)][ValidateRange(0, 32)][int]$PrefixLength
|
||||||
|
)
|
||||||
|
|
||||||
|
if ($FirstAddress.AddressFamily -ne [Net.Sockets.AddressFamily]::InterNetwork -or
|
||||||
|
$SecondAddress.AddressFamily -ne [Net.Sockets.AddressFamily]::InterNetwork) {
|
||||||
|
return $false
|
||||||
}
|
}
|
||||||
|
|
||||||
$defaultRoute = Get-NetRoute -AddressFamily IPv4 -DestinationPrefix '0.0.0.0/0' `
|
$firstBytes = $FirstAddress.GetAddressBytes()
|
||||||
|
$secondBytes = $SecondAddress.GetAddressBytes()
|
||||||
|
$remainingBits = $PrefixLength
|
||||||
|
for ($index = 0; $index -lt 4; $index++) {
|
||||||
|
$bits = [Math]::Min(8, $remainingBits)
|
||||||
|
$mask = if ($bits -eq 0) {
|
||||||
|
0
|
||||||
|
}
|
||||||
|
elseif ($bits -eq 8) {
|
||||||
|
255
|
||||||
|
}
|
||||||
|
else {
|
||||||
|
256 - [int][Math]::Pow(2, 8 - $bits)
|
||||||
|
}
|
||||||
|
if (($firstBytes[$index] -band $mask) -ne ($secondBytes[$index] -band $mask)) {
|
||||||
|
return $false
|
||||||
|
}
|
||||||
|
$remainingBits -= $bits
|
||||||
|
}
|
||||||
|
return $true
|
||||||
|
}
|
||||||
|
|
||||||
|
function Test-PrivateIPv4Address {
|
||||||
|
param([Parameter(Mandatory)][ipaddress]$Address)
|
||||||
|
|
||||||
|
if ($Address.AddressFamily -ne [Net.Sockets.AddressFamily]::InterNetwork) {
|
||||||
|
return $false
|
||||||
|
}
|
||||||
|
$bytes = $Address.GetAddressBytes()
|
||||||
|
return $bytes[0] -eq 10 -or
|
||||||
|
($bytes[0] -eq 172 -and $bytes[1] -ge 16 -and $bytes[1] -le 31) -or
|
||||||
|
($bytes[0] -eq 192 -and $bytes[1] -eq 168)
|
||||||
|
}
|
||||||
|
|
||||||
|
function Wait-ClientInterface {
|
||||||
|
param(
|
||||||
|
[string]$RequestedAlias,
|
||||||
|
[Parameter(Mandatory)][ipaddress]$DomainControllerAddress,
|
||||||
|
[int]$TimeoutSeconds = 20
|
||||||
|
)
|
||||||
|
$deadline = (Get-Date).AddSeconds($TimeoutSeconds)
|
||||||
|
do {
|
||||||
|
try {
|
||||||
|
return Resolve-ClientInterfaceAlias -RequestedAlias $RequestedAlias `
|
||||||
|
-DomainControllerAddress $DomainControllerAddress
|
||||||
|
}
|
||||||
|
catch {
|
||||||
|
$lastFailure = $_
|
||||||
|
if ((Get-Date) -ge $deadline) { throw $lastFailure }
|
||||||
|
Write-Host 'Waiting for DHCP, VPN routes or server connectivity to become ready...'
|
||||||
|
Start-Sleep -Seconds 2
|
||||||
|
}
|
||||||
|
} while ($true)
|
||||||
|
}
|
||||||
|
|
||||||
|
function Assert-UsableClientIPv4Address {
|
||||||
|
param(
|
||||||
|
[Parameter(Mandatory)][ipaddress]$Address,
|
||||||
|
[Parameter(Mandatory)][ipaddress]$DomainControllerAddress,
|
||||||
|
[Parameter(Mandatory)][ValidateRange(1, 32)][int]$PrefixLength
|
||||||
|
)
|
||||||
|
|
||||||
|
if ($Address.AddressFamily -ne [Net.Sockets.AddressFamily]::InterNetwork) {
|
||||||
|
throw "The SGU client address '$Address' must be IPv4."
|
||||||
|
}
|
||||||
|
if ($Address.IPAddressToString -eq $DomainControllerAddress.IPAddressToString) {
|
||||||
|
throw 'The SGU client and domain controller cannot use the same IPv4 address.'
|
||||||
|
}
|
||||||
|
if ($Address.IPAddressToString -match '^(0\.|127\.|169\.254\.|22[4-9]\.|23\d\.)') {
|
||||||
|
throw "The SGU client address '$Address' is not usable on the private domain network."
|
||||||
|
}
|
||||||
|
if (-not (Test-IPv4AddressesSharePrefix -FirstAddress $Address `
|
||||||
|
-SecondAddress $DomainControllerAddress -PrefixLength $PrefixLength)) {
|
||||||
|
throw "The SGU client address '$Address/$PrefixLength' is not on the same network as domain controller $DomainControllerAddress."
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
function Set-ClientDomainAddress {
|
||||||
|
param(
|
||||||
|
[Parameter(Mandatory)][string]$InterfaceAlias,
|
||||||
|
[Parameter(Mandatory)][ipaddress]$DomainControllerAddress,
|
||||||
|
[ipaddress]$RequestedAddress,
|
||||||
|
[Parameter(Mandatory)][ValidateRange(1, 32)][int]$PrefixLength
|
||||||
|
)
|
||||||
|
|
||||||
|
$adapter = Get-NetAdapter -Name $InterfaceAlias -ErrorAction Stop
|
||||||
|
$matchingAddress = Get-NetIPAddress -InterfaceIndex $adapter.ifIndex -AddressFamily IPv4 `
|
||||||
-ErrorAction SilentlyContinue |
|
-ErrorAction SilentlyContinue |
|
||||||
Sort-Object RouteMetric,InterfaceMetric |
|
Where-Object {
|
||||||
|
$_.AddressState -eq 'Preferred' -and
|
||||||
|
$_.IPAddress -notmatch '^(127\.|169\.254\.)' -and
|
||||||
|
(Test-IPv4AddressesSharePrefix -FirstAddress ([ipaddress]$_.IPAddress) `
|
||||||
|
-SecondAddress $DomainControllerAddress -PrefixLength $PrefixLength)
|
||||||
|
} |
|
||||||
Select-Object -First 1
|
Select-Object -First 1
|
||||||
if ($defaultRoute) {
|
|
||||||
return [string](Get-NetAdapter -InterfaceIndex $defaultRoute.InterfaceIndex).Name
|
if (-not $RequestedAddress -and $matchingAddress) {
|
||||||
|
return [ipaddress]$matchingAddress.IPAddress
|
||||||
|
}
|
||||||
|
if (-not $RequestedAddress) {
|
||||||
|
throw 'Static addressing requires an explicit -ClientIPv4Address. Automatic enrollment preserves DHCP and existing addresses.'
|
||||||
|
}
|
||||||
|
Assert-UsableClientIPv4Address -Address $RequestedAddress `
|
||||||
|
-DomainControllerAddress $DomainControllerAddress -PrefixLength $PrefixLength
|
||||||
|
|
||||||
|
Set-NetIPInterface -InterfaceIndex $adapter.ifIndex -AddressFamily IPv4 -Dhcp Disabled
|
||||||
|
$existingAddresses = @(Get-NetIPAddress -InterfaceIndex $adapter.ifIndex -AddressFamily IPv4 `
|
||||||
|
-ErrorAction SilentlyContinue | Where-Object PrefixOrigin -ne 'WellKnown')
|
||||||
|
foreach ($existingAddress in $existingAddresses) {
|
||||||
|
if ($existingAddress.IPAddress -ne $RequestedAddress.IPAddressToString -or
|
||||||
|
[int]$existingAddress.PrefixLength -ne $PrefixLength) {
|
||||||
|
Remove-NetIPAddress -InputObject $existingAddress -Confirm:$false
|
||||||
|
}
|
||||||
|
}
|
||||||
|
if (-not (Get-NetIPAddress -InterfaceIndex $adapter.ifIndex -AddressFamily IPv4 `
|
||||||
|
-IPAddress $RequestedAddress.IPAddressToString -ErrorAction SilentlyContinue)) {
|
||||||
|
New-NetIPAddress -InterfaceIndex $adapter.ifIndex -AddressFamily IPv4 `
|
||||||
|
-IPAddress $RequestedAddress.IPAddressToString -PrefixLength $PrefixLength | Out-Null
|
||||||
}
|
}
|
||||||
|
|
||||||
$upAdapters = @(Get-NetAdapter | Where-Object Status -eq 'Up')
|
$addressReadyDeadline = (Get-Date).AddSeconds(20)
|
||||||
if ($upAdapters.Count -eq 1) {
|
do {
|
||||||
return [string]$upAdapters[0].Name
|
$configuredAddress = Get-NetIPAddress -InterfaceIndex $adapter.ifIndex `
|
||||||
}
|
-AddressFamily IPv4 -IPAddress $RequestedAddress.IPAddressToString `
|
||||||
|
-ErrorAction SilentlyContinue
|
||||||
|
if ($configuredAddress -and $configuredAddress.AddressState -eq 'Preferred') {
|
||||||
|
return $RequestedAddress
|
||||||
|
}
|
||||||
|
Start-Sleep -Milliseconds 500
|
||||||
|
} while ((Get-Date) -lt $addressReadyDeadline)
|
||||||
|
|
||||||
$aliases = ($upAdapters.Name | Sort-Object) -join ', '
|
$observedState = if ($configuredAddress) { $configuredAddress.AddressState } else { 'Missing' }
|
||||||
throw "Could not select a network adapter. Re-run with -NetworkInterfaceAlias. Available adapters: $aliases"
|
throw "The SGU client address '$RequestedAddress' did not become ready on '$InterfaceAlias' within 20 seconds. Observed state: $observedState."
|
||||||
}
|
}
|
||||||
|
|
||||||
function Test-TcpPort {
|
function Test-TcpPort {
|
||||||
param(
|
param(
|
||||||
[Parameter(Mandatory)][ipaddress]$Address,
|
[Parameter(Mandatory)][ipaddress]$Address,
|
||||||
[Parameter(Mandatory)][int]$Port,
|
[Parameter(Mandatory)][int]$Port,
|
||||||
[int]$TimeoutMilliseconds = 5000
|
[int]$TimeoutMilliseconds = 5000,
|
||||||
|
[ipaddress]$SourceAddress,
|
||||||
|
[int]$InterfaceIndex
|
||||||
)
|
)
|
||||||
|
|
||||||
$client = [Net.Sockets.TcpClient]::new()
|
$client = [Net.Sockets.TcpClient]::new([Net.Sockets.AddressFamily]::InterNetwork)
|
||||||
|
$connect = $null
|
||||||
try {
|
try {
|
||||||
|
if ($InterfaceIndex) {
|
||||||
|
# IP_UNICAST_IF (31) expects the interface index in network byte order.
|
||||||
|
$client.Client.SetSocketOption([Net.Sockets.SocketOptionLevel]::IP,
|
||||||
|
[Net.Sockets.SocketOptionName]31, [Net.IPAddress]::HostToNetworkOrder($InterfaceIndex))
|
||||||
|
}
|
||||||
|
if ($SourceAddress) {
|
||||||
|
$client.Client.Bind([Net.IPEndPoint]::new($SourceAddress, 0))
|
||||||
|
}
|
||||||
$connect = $client.BeginConnect($Address, $Port, $null, $null)
|
$connect = $client.BeginConnect($Address, $Port, $null, $null)
|
||||||
if (-not $connect.AsyncWaitHandle.WaitOne($TimeoutMilliseconds)) {
|
if (-not $connect.AsyncWaitHandle.WaitOne($TimeoutMilliseconds)) {
|
||||||
return $false
|
return $false
|
||||||
@@ -92,30 +327,223 @@ function Test-TcpPort {
|
|||||||
}
|
}
|
||||||
finally {
|
finally {
|
||||||
$client.Dispose()
|
$client.Dispose()
|
||||||
|
if ($connect) { $connect.AsyncWaitHandle.Close() }
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
function Set-ClientServerRoute {
|
||||||
|
param(
|
||||||
|
[Parameter(Mandatory)]$SelectedInterface,
|
||||||
|
[Parameter(Mandatory)][ipaddress]$DomainControllerAddress
|
||||||
|
)
|
||||||
|
$current = @(Find-NetRoute -RemoteIPAddress $DomainControllerAddress.IPAddressToString |
|
||||||
|
Where-Object { $_.PSObject.Properties['IPAddress'] })
|
||||||
|
if (@($current | Where-Object InterfaceIndex -eq $SelectedInterface.InterfaceIndex).Count -gt 0) { return }
|
||||||
|
|
||||||
|
# Only pin this server when Windows currently chooses a different interface.
|
||||||
|
# Do not replace default routes or change interface metrics used by Internet traffic.
|
||||||
|
$route = New-NetRoute -DestinationPrefix "$DomainControllerAddress/32" `
|
||||||
|
-InterfaceIndex $SelectedInterface.InterfaceIndex -NextHop $SelectedInterface.NextHop `
|
||||||
|
-RouteMetric 1
|
||||||
|
$current = @(Find-NetRoute -RemoteIPAddress $DomainControllerAddress.IPAddressToString |
|
||||||
|
Where-Object { $_.PSObject.Properties['IPAddress'] })
|
||||||
|
if (@($current | Where-Object InterfaceIndex -eq $SelectedInterface.InterfaceIndex).Count -eq 0) {
|
||||||
|
$route | Remove-NetRoute -Confirm:$false
|
||||||
|
throw "Windows still routes $DomainControllerAddress through another interface. Resolve conflicting host routes or VPN policies and retry."
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
function Set-ClientDomainDns {
|
||||||
|
param(
|
||||||
|
[Parameter(Mandatory)][string]$DnsDomain,
|
||||||
|
[Parameter(Mandatory)][ipaddress]$ServerAddress
|
||||||
|
)
|
||||||
|
$displayName = "SGU domain DNS - $DnsDomain"
|
||||||
|
$existing = @(Get-DnsClientNrptRule -ErrorAction Stop | Where-Object DisplayName -eq $displayName)
|
||||||
|
if ($existing.Count -eq 1 -and @($existing[0].NameServers) -contains $ServerAddress.IPAddressToString -and
|
||||||
|
@($existing[0].Namespace) -contains ".$DnsDomain" -and @($existing[0].Namespace) -contains $DnsDomain) { return }
|
||||||
|
$existing | Remove-DnsClientNrptRule -Force
|
||||||
|
Add-DnsClientNrptRule -Namespace @($DnsDomain, ".$DnsDomain") `
|
||||||
|
-NameServers $ServerAddress.IPAddressToString -DisplayName $displayName | Out-Null
|
||||||
|
Clear-DnsClientCache
|
||||||
|
}
|
||||||
|
|
||||||
|
function Test-ClientDomainDns {
|
||||||
|
param([Parameter(Mandatory)][string]$DnsDomain)
|
||||||
|
|
||||||
|
try {
|
||||||
|
$records = @(Resolve-DnsName -Type SRV "_ldap._tcp.dc._msdcs.$DnsDomain" `
|
||||||
|
-DnsOnly -ErrorAction Stop)
|
||||||
|
return @($records | Where-Object {
|
||||||
|
$_.Type -eq 'SRV' -and -not [string]::IsNullOrWhiteSpace([string]$_.NameTarget)
|
||||||
|
}).Count -gt 0
|
||||||
|
}
|
||||||
|
catch {
|
||||||
|
return $false
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
function Set-ClientHostMappings {
|
||||||
|
param(
|
||||||
|
[Parameter(Mandatory)][ipaddress]$ServerAddress,
|
||||||
|
[Parameter(Mandatory)][string[]]$HostNames
|
||||||
|
)
|
||||||
|
|
||||||
|
$hostsPath = Join-Path $env:SystemRoot 'System32\drivers\etc\hosts'
|
||||||
|
$managedNames = @($HostNames |
|
||||||
|
Where-Object { -not [string]::IsNullOrWhiteSpace($_) } |
|
||||||
|
ForEach-Object { $_.Trim().ToLowerInvariant() } |
|
||||||
|
Select-Object -Unique)
|
||||||
|
$preservedLines = foreach ($line in [IO.File]::ReadAllLines($hostsPath)) {
|
||||||
|
$data = ($line -split '#', 2)[0].Trim()
|
||||||
|
$tokens = @($data -split '\s+' | Where-Object { $_ })
|
||||||
|
$lineNames = if ($tokens.Count -gt 1) {
|
||||||
|
@($tokens[1..($tokens.Count - 1)] | ForEach-Object { $_.ToLowerInvariant() })
|
||||||
|
}
|
||||||
|
else { @() }
|
||||||
|
if (@($lineNames | Where-Object { $managedNames -contains $_ }).Count -eq 0) {
|
||||||
|
$line
|
||||||
|
}
|
||||||
|
}
|
||||||
|
$mapping = '{0} {1} # SGU managed direct enrollment' -f
|
||||||
|
$ServerAddress.IPAddressToString,($managedNames -join ' ')
|
||||||
|
[IO.File]::WriteAllLines($hostsPath, @($preservedLines) + $mapping,
|
||||||
|
[Text.UTF8Encoding]::new($false))
|
||||||
|
Clear-DnsClientCache
|
||||||
|
}
|
||||||
|
|
||||||
|
function Enable-ClientDnsOverHttps {
|
||||||
|
param(
|
||||||
|
[Parameter(Mandatory)][ipaddress]$ServerAddress,
|
||||||
|
[Parameter(Mandatory)][string]$DohTemplate,
|
||||||
|
[Parameter(Mandatory)][string]$CertificateBase64
|
||||||
|
)
|
||||||
|
|
||||||
|
if (-not (Get-Command Add-DnsClientDohServerAddress -ErrorAction SilentlyContinue)) {
|
||||||
|
throw 'This Windows build cannot configure DNS over HTTPS. Permit traditional DNS to the supplied server or update Windows, then retry.'
|
||||||
|
}
|
||||||
|
|
||||||
|
$certificate = [Security.Cryptography.X509Certificates.X509Certificate2]::new(
|
||||||
|
[Convert]::FromBase64String($CertificateBase64))
|
||||||
|
$store = [Security.Cryptography.X509Certificates.X509Store]::new(
|
||||||
|
[Security.Cryptography.X509Certificates.StoreName]::Root,
|
||||||
|
[Security.Cryptography.X509Certificates.StoreLocation]::LocalMachine)
|
||||||
|
try {
|
||||||
|
$store.Open([Security.Cryptography.X509Certificates.OpenFlags]::ReadWrite)
|
||||||
|
if (-not @($store.Certificates | Where-Object Thumbprint -eq $certificate.Thumbprint).Count) {
|
||||||
|
$store.Add($certificate)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
finally {
|
||||||
|
$store.Close()
|
||||||
|
$certificate.Dispose()
|
||||||
|
}
|
||||||
|
|
||||||
|
$existing = Get-DnsClientDohServerAddress -ErrorAction SilentlyContinue |
|
||||||
|
Where-Object ServerAddress -eq $ServerAddress.IPAddressToString |
|
||||||
|
Select-Object -First 1
|
||||||
|
if ($existing) {
|
||||||
|
Set-DnsClientDohServerAddress -ServerAddress $ServerAddress.IPAddressToString `
|
||||||
|
-DohTemplate $DohTemplate -AllowFallbackToUdp $false -AutoUpgrade $true | Out-Null
|
||||||
|
}
|
||||||
|
else {
|
||||||
|
Add-DnsClientDohServerAddress -ServerAddress $ServerAddress.IPAddressToString `
|
||||||
|
-DohTemplate $DohTemplate -AllowFallbackToUdp $false -AutoUpgrade $true | Out-Null
|
||||||
|
}
|
||||||
|
& "$env:SystemRoot\System32\netsh.exe" dnsclient set global doh=yes | Out-Null
|
||||||
|
if ($LASTEXITCODE -ne 0) {
|
||||||
|
throw 'Windows did not enable its global DNS over HTTPS client setting.'
|
||||||
|
}
|
||||||
|
Clear-DnsClientCache
|
||||||
|
}
|
||||||
|
|
||||||
|
function Assert-ClientOperatingSystem {
|
||||||
|
param(
|
||||||
|
[Parameter(Mandatory)]$OperatingSystem,
|
||||||
|
[Parameter(Mandatory)][string]$Edition,
|
||||||
|
[Parameter(Mandatory)][string]$Architecture
|
||||||
|
)
|
||||||
|
if ([int]$OperatingSystem.ProductType -ne 1) {
|
||||||
|
throw 'The client bootstrap supports Windows 10/11 workstations. Use the server bootstrap on Windows Server.'
|
||||||
|
}
|
||||||
|
if ([int]$OperatingSystem.BuildNumber -lt 14393 -or $Architecture -ne 'AMD64') {
|
||||||
|
throw 'This package requires Windows 10 1607 or later, or Windows 11, running x64 Windows PowerShell.'
|
||||||
|
}
|
||||||
|
if ($Edition -match '^Core' -or $Edition -match 'Home') {
|
||||||
|
throw "Windows edition '$Edition' cannot join an Active Directory domain. Upgrade to Pro, Enterprise, or Education, then run this same bootstrap again."
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
function Wait-TcpPort {
|
||||||
|
param(
|
||||||
|
[Parameter(Mandatory)][ipaddress]$Address,
|
||||||
|
[Parameter(Mandatory)][int]$Port,
|
||||||
|
[int]$TimeoutSeconds = 20
|
||||||
|
)
|
||||||
|
|
||||||
|
$deadline = (Get-Date).AddSeconds($TimeoutSeconds)
|
||||||
|
do {
|
||||||
|
if (Test-TcpPort -Address $Address -Port $Port -TimeoutMilliseconds 2000) {
|
||||||
|
return $true
|
||||||
|
}
|
||||||
|
Start-Sleep -Milliseconds 750
|
||||||
|
} while ((Get-Date) -lt $deadline)
|
||||||
|
return $false
|
||||||
|
}
|
||||||
|
|
||||||
|
function Connect-SguAzureP2s {
|
||||||
|
param([Parameter(Mandatory)][string]$ConnectionName)
|
||||||
|
|
||||||
|
$connection = Get-VpnConnection -Name $ConnectionName -AllUserConnection `
|
||||||
|
-ErrorAction SilentlyContinue
|
||||||
|
if (-not $connection) {
|
||||||
|
throw "The all-user VPN connection '$ConnectionName' is not installed. Run Install-SguAzureP2sClient.ps1 in this VM first."
|
||||||
|
}
|
||||||
|
if ($connection.TunnelType -notcontains 'Ikev2' -and $connection.TunnelType -ne 'Ikev2') {
|
||||||
|
throw "The VPN connection '$ConnectionName' is not configured for IKEv2."
|
||||||
|
}
|
||||||
|
if ($connection.ConnectionStatus -ne 'Connected') {
|
||||||
|
& "$env:SystemRoot\System32\rasdial.exe" $ConnectionName
|
||||||
|
if ($LASTEXITCODE -ne 0) {
|
||||||
|
throw "Could not connect the Azure P2S profile '$ConnectionName'. Verify the machine certificate and that UDP 500/4500 is permitted by the local network."
|
||||||
|
}
|
||||||
|
}
|
||||||
|
$connection = Get-VpnConnection -Name $ConnectionName -AllUserConnection
|
||||||
|
if ($connection.ConnectionStatus -ne 'Connected') {
|
||||||
|
throw "The Azure P2S profile '$ConnectionName' did not reach Connected state."
|
||||||
|
}
|
||||||
|
return $connection
|
||||||
|
}
|
||||||
|
|
||||||
Assert-Administrator
|
Assert-Administrator
|
||||||
$operatingSystem = Get-CimInstance Win32_OperatingSystem
|
$operatingSystem = Get-CimInstance Win32_OperatingSystem
|
||||||
if ([int]$operatingSystem.ProductType -ne 1) {
|
|
||||||
throw 'The client bootstrap supports Windows 10/11 workstations. Use the server bootstrap on Windows Server.'
|
|
||||||
}
|
|
||||||
|
|
||||||
$edition = (Get-WindowsEdition -Online).Edition
|
$edition = (Get-WindowsEdition -Online).Edition
|
||||||
if ($edition -match '^Core' -or $edition -match 'Home') {
|
Assert-ClientOperatingSystem -OperatingSystem $operatingSystem -Edition $edition `
|
||||||
throw "Windows edition '$edition' cannot join an on-premises Active Directory domain or host RDP. Upgrade to Pro, Enterprise, or Education, then run this same bootstrap again."
|
-Architecture $env:PROCESSOR_ARCHITECTURE
|
||||||
}
|
$windowsBuild = [int]$operatingSystem.BuildNumber
|
||||||
|
$windowsName = if ($windowsBuild -ge 22000) { 'Windows 11' } else { 'Windows 10' }
|
||||||
|
Write-Host "$windowsName (build $windowsBuild): unified SGU enrollment."
|
||||||
|
|
||||||
if (-not $DomainControllerIPv4Address) {
|
if (-not $DomainControllerIPv4Address) {
|
||||||
$DomainControllerIPv4Address = [ipaddress](Read-Host 'Fixed IPv4 address of the SGU domain controller')
|
$DomainControllerIPv4Address = [ipaddress](Read-Host 'Fixed IPv4 address of the SGU domain controller')
|
||||||
}
|
}
|
||||||
if (-not $ComputerOuDn) {
|
if ($DomainControllerIPv4Address.AddressFamily -ne [Net.Sockets.AddressFamily]::InterNetwork -or
|
||||||
$baseDn = (($DomainName -split '\.') | ForEach-Object { "DC=$_" }) -join ','
|
$DomainControllerIPv4Address.IPAddressToString -match '^(0\.|127\.|169\.254\.|22[4-9]\.|23\d\.|24\d\.|25[0-5]\.)') {
|
||||||
$ComputerOuDn = "OU=Laboratorio,$baseDn"
|
throw 'Enter a reachable unicast IPv4 address for the domain controller.'
|
||||||
|
}
|
||||||
|
$publicDirectEnrollment = $ConnectivityMode -eq 'Direct' -and
|
||||||
|
-not (Test-PrivateIPv4Address -Address $DomainControllerIPv4Address)
|
||||||
|
if ($publicDirectEnrollment) {
|
||||||
|
Write-Host 'Public domain-controller address detected. Direct DNS and domain discovery will be configured automatically.'
|
||||||
}
|
}
|
||||||
|
|
||||||
$packageRoot = $PSScriptRoot
|
$packageRoot = $PSScriptRoot
|
||||||
Assert-PackageManifest -PackageRoot $packageRoot
|
$packageManifest = Assert-PackageManifest -PackageRoot $packageRoot
|
||||||
|
# Retain the old parameter for existing automation; neither name restricts networking.
|
||||||
|
if ($CompatibilityProfile -ne 'Auto') {
|
||||||
|
Write-Warning 'CompatibilityProfile is deprecated. This package uses the same implementation on Windows 10 and 11.'
|
||||||
|
}
|
||||||
|
$CompatibilityProfile = 'Auto'
|
||||||
$scriptsRoot = Join-Path $packageRoot 'payload\scripts'
|
$scriptsRoot = Join-Path $packageRoot 'payload\scripts'
|
||||||
$providerPublishPath = Join-Path $packageRoot 'payload\credential-provider'
|
$providerPublishPath = Join-Path $packageRoot 'payload\credential-provider'
|
||||||
$runtimeInstaller = Get-ChildItem (Join-Path $packageRoot 'payload\prerequisites') `
|
$runtimeInstaller = Get-ChildItem (Join-Path $packageRoot 'payload\prerequisites') `
|
||||||
@@ -124,6 +552,8 @@ $runtimeInstaller = Get-ChildItem (Join-Path $packageRoot 'payload\prerequisites
|
|||||||
Select-Object -First 1
|
Select-Object -First 1
|
||||||
foreach ($requiredPath in @(
|
foreach ($requiredPath in @(
|
||||||
(Join-Path $scriptsRoot 'Enroll-SguDomainClient.ps1'),
|
(Join-Path $scriptsRoot 'Enroll-SguDomainClient.ps1'),
|
||||||
|
(Join-Path $scriptsRoot 'Install-SguFsLogix.ps1'),
|
||||||
|
(Join-Path $scriptsRoot 'Install-SguRustDeskClient.ps1'),
|
||||||
(Join-Path $scriptsRoot 'Register-SguClientCertificate.ps1'),
|
(Join-Path $scriptsRoot 'Register-SguClientCertificate.ps1'),
|
||||||
(Join-Path $providerPublishPath 'SGU.CredentialProvider.comhost.dll'))) {
|
(Join-Path $providerPublishPath 'SGU.CredentialProvider.comhost.dll'))) {
|
||||||
if (-not (Test-Path -LiteralPath $requiredPath -PathType Leaf)) {
|
if (-not (Test-Path -LiteralPath $requiredPath -PathType Leaf)) {
|
||||||
@@ -133,20 +563,79 @@ foreach ($requiredPath in @(
|
|||||||
if (-not $runtimeInstaller) {
|
if (-not $runtimeInstaller) {
|
||||||
throw 'The offline Microsoft .NET 10 x64 runtime installer is missing from the client package.'
|
throw 'The offline Microsoft .NET 10 x64 runtime installer is missing from the client package.'
|
||||||
}
|
}
|
||||||
|
if (-not $PSCmdlet.ShouldProcess($env:COMPUTERNAME, "Enroll with SGU server $DomainControllerIPv4Address")) { return }
|
||||||
|
$fsLogixResult = $null
|
||||||
|
if ($FsLogixInstallerPath) {
|
||||||
|
$fsLogixResult = & (Join-Path $scriptsRoot 'Install-SguFsLogix.ps1') `
|
||||||
|
-InstallerPath $FsLogixInstallerPath
|
||||||
|
}
|
||||||
|
elseif (Get-Service -Name frxsvc -ErrorAction SilentlyContinue) {
|
||||||
|
$fsLogixResult = [pscustomobject]@{
|
||||||
|
Installed = $true
|
||||||
|
Changed = $false
|
||||||
|
RestartRequired = $false
|
||||||
|
}
|
||||||
|
}
|
||||||
|
if ($ClientIPv4Address) {
|
||||||
|
if (-not $NetworkInterfaceAlias -or $ConnectivityMode -eq 'AzureP2S') {
|
||||||
|
throw 'Explicit static IP setup requires -NetworkInterfaceAlias with Direct connectivity. Omit -ClientIPv4Address to preserve the current LAN/VPN configuration.'
|
||||||
|
}
|
||||||
|
$ClientIPv4Address = Set-ClientDomainAddress -InterfaceAlias $NetworkInterfaceAlias `
|
||||||
|
-DomainControllerAddress $DomainControllerIPv4Address `
|
||||||
|
-RequestedAddress $ClientIPv4Address -PrefixLength $ClientPrefixLength
|
||||||
|
}
|
||||||
|
|
||||||
$NetworkInterfaceAlias = Resolve-ClientInterfaceAlias -RequestedAlias $NetworkInterfaceAlias
|
if ($ConnectivityMode -eq 'AzureP2S') {
|
||||||
Set-DnsClientServerAddress -InterfaceAlias $NetworkInterfaceAlias `
|
$existingVpnConnection = Get-VpnConnection -Name $VpnConnectionName -AllUserConnection `
|
||||||
-ServerAddresses $DomainControllerIPv4Address.IPAddressToString
|
-ErrorAction SilentlyContinue
|
||||||
|
if (-not $existingVpnConnection) {
|
||||||
|
$installerPath = Join-Path $packageRoot 'Install-SguAzureP2sClient.ps1'
|
||||||
|
if (-not (Test-Path -LiteralPath $installerPath -PathType Leaf)) {
|
||||||
|
throw 'Install-SguAzureP2sClient.ps1 is missing from the client bootstrap package.'
|
||||||
|
}
|
||||||
|
foreach ($vpnInput in @(
|
||||||
|
@{ Name = 'VpnProfilePackagePath'; Value = $VpnProfilePackagePath },
|
||||||
|
@{ Name = 'VpnClientCertificatePfxPath'; Value = $VpnClientCertificatePfxPath },
|
||||||
|
@{ Name = 'VpnClientRootCertificatePath'; Value = $VpnClientRootCertificatePath })) {
|
||||||
|
if ([string]::IsNullOrWhiteSpace([string]$vpnInput.Value)) {
|
||||||
|
throw "$($vpnInput.Name) is required the first time an Azure P2S client is enrolled."
|
||||||
|
}
|
||||||
|
}
|
||||||
|
$vpnInstallParameters = @{
|
||||||
|
VpnProfilePackagePath = $VpnProfilePackagePath
|
||||||
|
ClientCertificatePfxPath = $VpnClientCertificatePfxPath
|
||||||
|
ClientRootCertificatePath = $VpnClientRootCertificatePath
|
||||||
|
ConnectionName = $VpnConnectionName
|
||||||
|
AzureNetworkPrefixes = $AzureNetworkPrefixes
|
||||||
|
DomainControllerIPv4Address = $DomainControllerIPv4Address
|
||||||
|
DomainName = $DomainName
|
||||||
|
}
|
||||||
|
if ($VpnClientCertificatePfxPassword) {
|
||||||
|
$vpnInstallParameters.ClientCertificatePfxPassword = $VpnClientCertificatePfxPassword
|
||||||
|
}
|
||||||
|
& $installerPath @vpnInstallParameters | Out-Null
|
||||||
|
}
|
||||||
|
$vpnConnection = Connect-SguAzureP2s -ConnectionName $VpnConnectionName
|
||||||
|
}
|
||||||
|
$selectedInterface = Wait-ClientInterface -RequestedAlias $NetworkInterfaceAlias `
|
||||||
|
-DomainControllerAddress $DomainControllerIPv4Address
|
||||||
|
$NetworkInterfaceAlias = $selectedInterface.InterfaceAlias
|
||||||
|
$ClientIPv4Address = [ipaddress]$selectedInterface.IPAddress
|
||||||
|
Set-ClientServerRoute -SelectedInterface $selectedInterface -DomainControllerAddress $DomainControllerIPv4Address
|
||||||
|
Write-Host "Using $NetworkInterfaceAlias ($ClientIPv4Address)."
|
||||||
|
|
||||||
if (-not (Test-TcpPort -Address $DomainControllerIPv4Address -Port 5985)) {
|
if (-not (Wait-TcpPort -Address $DomainControllerIPv4Address -Port 5985 -TimeoutSeconds 20)) {
|
||||||
throw "The domain controller at $DomainControllerIPv4Address is not accepting WinRM on TCP 5985. Run the server bootstrap first and verify the selected IP."
|
throw "The domain controller at $DomainControllerIPv4Address did not accept WinRM on TCP 5985 after 20 seconds. Run the server bootstrap first and verify the selected IP."
|
||||||
}
|
}
|
||||||
|
|
||||||
if (-not $DomainCredential) {
|
if (-not $DomainCredential) {
|
||||||
|
$suggestedUser = if ($DomainNetbios) { "$DomainNetbios\Administrator" }
|
||||||
|
elseif ($DomainName) { "Administrator@$DomainName" } else { 'Administrator' }
|
||||||
$DomainCredential = Get-Credential `
|
$DomainCredential = Get-Credential `
|
||||||
-UserName "$DomainNetbios\Administrator" `
|
-UserName $suggestedUser `
|
||||||
-Message "Credential permitted to enroll this computer in $DomainName"
|
-Message "Domain account permitted to enroll this computer (DOMAIN\user or user@domain)"
|
||||||
}
|
}
|
||||||
|
if (-not $DomainCredential) { throw 'Enrollment cancelled: no domain credential was provided.' }
|
||||||
|
|
||||||
New-Item -ItemType Directory -Path $temporaryRoot -Force | Out-Null
|
New-Item -ItemType Directory -Path $temporaryRoot -Force | Out-Null
|
||||||
$clientCertificatePath = Join-Path $temporaryRoot 'client.cer'
|
$clientCertificatePath = Join-Path $temporaryRoot 'client.cer'
|
||||||
@@ -176,20 +665,196 @@ try {
|
|||||||
|
|
||||||
$serverIdentity = Invoke-Command -Session $session -ScriptBlock {
|
$serverIdentity = Invoke-Command -Session $session -ScriptBlock {
|
||||||
$computer = Get-CimInstance Win32_ComputerSystem
|
$computer = Get-CimInstance Win32_ComputerSystem
|
||||||
|
if ([int]$computer.DomainRole -lt 4) { throw 'The supplied server is not an Active Directory domain controller.' }
|
||||||
|
Import-Module ActiveDirectory -ErrorAction Stop
|
||||||
|
$domain = Get-ADDomain -ErrorAction Stop
|
||||||
|
$labOu = Get-ADOrganizationalUnit -LDAPFilter '(ou=Laboratorio)' `
|
||||||
|
-SearchBase $domain.DistinguishedName -SearchScope OneLevel -ErrorAction Stop |
|
||||||
|
Select-Object -First 1
|
||||||
$brokerService = Get-Service SGUAuthBroker -ErrorAction SilentlyContinue
|
$brokerService = Get-Service SGUAuthBroker -ErrorAction SilentlyContinue
|
||||||
|
$rustDeskStatusPath = Join-Path $env:ProgramData 'SGU\RustDesk\server.json'
|
||||||
|
$rustDeskStatus = if (Test-Path -LiteralPath $rustDeskStatusPath -PathType Leaf) {
|
||||||
|
Get-Content -LiteralPath $rustDeskStatusPath -Raw | ConvertFrom-Json
|
||||||
|
}
|
||||||
|
else {
|
||||||
|
$null
|
||||||
|
}
|
||||||
|
$hbbsTask = Get-ScheduledTask -TaskName 'SGU-RustDesk-hbbs' -ErrorAction SilentlyContinue
|
||||||
|
$hbbrTask = Get-ScheduledTask -TaskName 'SGU-RustDesk-hbbr' -ErrorAction SilentlyContinue
|
||||||
[pscustomobject]@{
|
[pscustomobject]@{
|
||||||
ComputerName = $env:COMPUTERNAME
|
ComputerName = $env:COMPUTERNAME
|
||||||
Domain = $computer.Domain
|
Domain = $computer.Domain
|
||||||
|
DomainNetbios = $domain.NetBIOSName
|
||||||
|
ComputerContainer = if ($labOu) { $labOu.DistinguishedName } else { $domain.ComputersContainer }
|
||||||
BrokerService = if ($brokerService) { $brokerService.Status.ToString() } else { 'Missing' }
|
BrokerService = if ($brokerService) { $brokerService.Status.ToString() } else { 'Missing' }
|
||||||
|
RustDeskServerAddress = if ($rustDeskStatus) { [string]$rustDeskStatus.ServerAddress } else { $null }
|
||||||
|
RustDeskPublicKey = if ($rustDeskStatus) { [string]$rustDeskStatus.PublicKey } else { $null }
|
||||||
|
RustDeskHbbsTask = if ($hbbsTask) { $hbbsTask.State.ToString() } else { 'Missing' }
|
||||||
|
RustDeskHbbrTask = if ($hbbrTask) { $hbbrTask.State.ToString() } else { 'Missing' }
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
if (-not $serverIdentity.Domain -or
|
if (-not $serverIdentity.Domain -or ($DomainName -and
|
||||||
-not $serverIdentity.Domain.Equals($DomainName, [StringComparison]::OrdinalIgnoreCase)) {
|
-not $serverIdentity.Domain.Equals($DomainName, [StringComparison]::OrdinalIgnoreCase))) {
|
||||||
throw "The server at $DomainControllerIPv4Address belongs to $($serverIdentity.Domain), not $DomainName."
|
throw "The server at $DomainControllerIPv4Address belongs to $($serverIdentity.Domain), not $DomainName."
|
||||||
}
|
}
|
||||||
|
if ($DomainNetbios -and $DomainNetbios -ne $serverIdentity.DomainNetbios) {
|
||||||
|
throw "The supplied NetBIOS domain '$DomainNetbios' does not match '$($serverIdentity.DomainNetbios)'."
|
||||||
|
}
|
||||||
|
$DomainName = [string]$serverIdentity.Domain
|
||||||
|
$DomainNetbios = [string]$serverIdentity.DomainNetbios
|
||||||
|
if (-not $ComputerOuDn) { $ComputerOuDn = [string]$serverIdentity.ComputerContainer }
|
||||||
|
$brokerDnsName = "$brokerRecordName.$DomainName"
|
||||||
|
$brokerEndpoint = "https://${brokerDnsName}:8443/v1/authenticate"
|
||||||
|
Write-Host "Discovered domain: $DomainName ($DomainNetbios). Computer container: $ComputerOuDn"
|
||||||
if ($serverIdentity.BrokerService -ne 'Running') {
|
if ($serverIdentity.BrokerService -ne 'Running') {
|
||||||
throw "The SGU Authentication Broker is not running on $($serverIdentity.ComputerName)."
|
throw "The SGU Authentication Broker is not running on $($serverIdentity.ComputerName)."
|
||||||
}
|
}
|
||||||
|
if ([string]::IsNullOrWhiteSpace($serverIdentity.RustDeskServerAddress) -or
|
||||||
|
[string]::IsNullOrWhiteSpace($serverIdentity.RustDeskPublicKey) -or
|
||||||
|
$serverIdentity.RustDeskHbbsTask -ne 'Running' -or
|
||||||
|
$serverIdentity.RustDeskHbbrTask -ne 'Running') {
|
||||||
|
throw "The RustDesk server is not ready on $($serverIdentity.ComputerName). Run the current server bootstrap first."
|
||||||
|
}
|
||||||
|
|
||||||
|
$targetComputerName = if ($NewComputerName) { $NewComputerName } else { $env:COMPUTERNAME }
|
||||||
|
Invoke-Command -Session $session -ScriptBlock {
|
||||||
|
param($ComputerName, $ComputerPath)
|
||||||
|
Import-Module ActiveDirectory -ErrorAction Stop
|
||||||
|
$samAccountName = "$ComputerName`$"
|
||||||
|
$account = Get-ADComputer -Filter "SamAccountName -eq '$samAccountName'" |
|
||||||
|
Select-Object -First 1
|
||||||
|
if (-not $account) {
|
||||||
|
New-ADComputer -Name $ComputerName -SamAccountName $samAccountName `
|
||||||
|
-Path $ComputerPath -Enabled $true -ErrorAction Stop
|
||||||
|
}
|
||||||
|
} -ArgumentList $targetComputerName,$ComputerOuDn
|
||||||
|
|
||||||
|
if ($publicDirectEnrollment) {
|
||||||
|
$directDns = Invoke-Command -Session $session -ScriptBlock {
|
||||||
|
param($DnsDomain, $DomainControllerComputerName)
|
||||||
|
|
||||||
|
$domainControllerFqdn = "$DomainControllerComputerName.$DnsDomain".ToLowerInvariant()
|
||||||
|
$dohTemplate = "https://${domainControllerFqdn}:443/dns-query"
|
||||||
|
$dohCommand = Get-Command Set-DnsServerEncryptionProtocol -ErrorAction SilentlyContinue
|
||||||
|
if (-not $dohCommand) {
|
||||||
|
return [pscustomobject]@{
|
||||||
|
DohSupported = $false
|
||||||
|
DomainControllerFqdn = $domainControllerFqdn
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
$certificate = Get-ChildItem Cert:\LocalMachine\My |
|
||||||
|
Where-Object {
|
||||||
|
$_.Subject -eq "CN=$domainControllerFqdn" -and
|
||||||
|
$_.HasPrivateKey -and
|
||||||
|
$_.NotAfter -gt (Get-Date).AddDays(30)
|
||||||
|
} |
|
||||||
|
Sort-Object NotAfter -Descending |
|
||||||
|
Select-Object -First 1
|
||||||
|
if (-not $certificate) {
|
||||||
|
$certificate = New-SelfSignedCertificate `
|
||||||
|
-DnsName $domainControllerFqdn `
|
||||||
|
-CertStoreLocation Cert:\LocalMachine\My `
|
||||||
|
-FriendlyName 'SGU Direct Enrollment DoH' `
|
||||||
|
-Type SSLServerAuthentication `
|
||||||
|
-KeyAlgorithm RSA `
|
||||||
|
-KeyLength 2048 `
|
||||||
|
-HashAlgorithm SHA256 `
|
||||||
|
-KeyExportPolicy NonExportable `
|
||||||
|
-NotAfter (Get-Date).AddYears(2)
|
||||||
|
}
|
||||||
|
|
||||||
|
$bindingOutput = @(& "$env:SystemRoot\System32\netsh.exe" http show sslcert ipport=0.0.0.0:443 2>&1)
|
||||||
|
$bindingExists = $LASTEXITCODE -eq 0
|
||||||
|
$normalizedBinding = (($bindingOutput -join '') -replace '[^0-9A-Fa-f]', '').ToUpperInvariant()
|
||||||
|
$normalizedThumbprint = ($certificate.Thumbprint -replace ' ', '').ToUpperInvariant()
|
||||||
|
if ($bindingExists -and -not $normalizedBinding.Contains($normalizedThumbprint)) {
|
||||||
|
throw 'TCP 443 already has an HTTPS certificate binding that is not managed by SGU. Free that port or configure SGU DoH before enrolling this client.'
|
||||||
|
}
|
||||||
|
if (-not $bindingExists) {
|
||||||
|
& "$env:SystemRoot\System32\netsh.exe" http add sslcert `
|
||||||
|
ipport=0.0.0.0:443 "certhash=$($certificate.Thumbprint)" `
|
||||||
|
"appid={47E9CF26-79B7-4C9D-A0AE-ADFA22447A41}" certstorename=MY | Out-Null
|
||||||
|
if ($LASTEXITCODE -ne 0) { throw 'Could not bind the SGU DoH certificate to TCP 443.' }
|
||||||
|
}
|
||||||
|
|
||||||
|
$dnsChanged = $false
|
||||||
|
$encryption = Get-DnsServerEncryptionProtocol
|
||||||
|
if (-not $encryption.EnableDoh -or $encryption.UriTemplate -ne $dohTemplate) {
|
||||||
|
Set-DnsServerEncryptionProtocol -EnableDoh $true -UriTemplate $dohTemplate
|
||||||
|
$dnsChanged = $true
|
||||||
|
}
|
||||||
|
|
||||||
|
Import-Module ActiveDirectory -ErrorAction Stop
|
||||||
|
$domainController = Get-ADComputer -Identity $DomainControllerComputerName `
|
||||||
|
-Properties ServicePrincipalName
|
||||||
|
if (@($domainController.ServicePrincipalName) -notcontains "cifs/$DnsDomain") {
|
||||||
|
& "$env:SystemRoot\System32\setspn.exe" -S "cifs/$DnsDomain" $DomainControllerComputerName | Out-Null
|
||||||
|
if ($LASTEXITCODE -ne 0) { throw "Could not register cifs/$DnsDomain on $DomainControllerComputerName." }
|
||||||
|
}
|
||||||
|
|
||||||
|
$lanmanPath = 'HKLM:\SYSTEM\CurrentControlSet\Services\LanmanServer\Parameters'
|
||||||
|
$optionalNames = @((Get-ItemProperty $lanmanPath -Name OptionalNames `
|
||||||
|
-ErrorAction SilentlyContinue).OptionalNames | Where-Object { $_ })
|
||||||
|
$serverChanged = $false
|
||||||
|
if ($optionalNames -notcontains $DnsDomain) {
|
||||||
|
New-ItemProperty -Path $lanmanPath -Name OptionalNames -PropertyType MultiString `
|
||||||
|
-Value (@($optionalNames) + $DnsDomain) -Force | Out-Null
|
||||||
|
$serverChanged = $true
|
||||||
|
}
|
||||||
|
New-ItemProperty -Path $lanmanPath -Name DisableStrictNameChecking `
|
||||||
|
-PropertyType DWord -Value 1 -Force | Out-Null
|
||||||
|
|
||||||
|
if ($serverChanged) {
|
||||||
|
Restart-Service LanmanServer -Force
|
||||||
|
Start-Service Netlogon
|
||||||
|
}
|
||||||
|
if ($dnsChanged) {
|
||||||
|
Restart-Service DNS -Force
|
||||||
|
Start-Sleep -Seconds 2
|
||||||
|
}
|
||||||
|
|
||||||
|
[pscustomobject]@{
|
||||||
|
DohSupported = $true
|
||||||
|
DohTemplate = $dohTemplate
|
||||||
|
DohCertificateBase64 = [Convert]::ToBase64String($certificate.RawData)
|
||||||
|
DomainControllerFqdn = $domainControllerFqdn
|
||||||
|
}
|
||||||
|
} -ArgumentList $DomainName,$serverIdentity.ComputerName
|
||||||
|
|
||||||
|
$directHostNames = @(
|
||||||
|
$directDns.DomainControllerFqdn,
|
||||||
|
$DomainName,
|
||||||
|
$brokerDnsName
|
||||||
|
)
|
||||||
|
if ([string]$serverIdentity.RustDeskServerAddress -match '[A-Za-z]') {
|
||||||
|
$directHostNames += [string]$serverIdentity.RustDeskServerAddress
|
||||||
|
}
|
||||||
|
Set-ClientHostMappings -ServerAddress $DomainControllerIPv4Address `
|
||||||
|
-HostNames $directHostNames
|
||||||
|
|
||||||
|
if ($directDns.DohSupported -and
|
||||||
|
(Get-Command Add-DnsClientDohServerAddress -ErrorAction SilentlyContinue)) {
|
||||||
|
Enable-ClientDnsOverHttps -ServerAddress $DomainControllerIPv4Address `
|
||||||
|
-DohTemplate $directDns.DohTemplate `
|
||||||
|
-CertificateBase64 $directDns.DohCertificateBase64
|
||||||
|
}
|
||||||
|
elseif (-not $directDns.DohSupported) {
|
||||||
|
Write-Warning 'The server does not support DNS over HTTPS; enrollment will use traditional DNS.'
|
||||||
|
}
|
||||||
|
else {
|
||||||
|
Write-Warning 'This Windows build does not support DNS over HTTPS; enrollment will use traditional DNS.'
|
||||||
|
}
|
||||||
|
}
|
||||||
|
Set-ClientDomainDns -DnsDomain $DomainName -ServerAddress $DomainControllerIPv4Address
|
||||||
|
if (-not (Test-ClientDomainDns -DnsDomain $DomainName)) {
|
||||||
|
throw "The domain DNS service at $DomainControllerIPv4Address did not return an Active Directory SRV record. For a public server, permit DNS over HTTPS on TCP 443 or traditional DNS from this client network."
|
||||||
|
}
|
||||||
|
foreach ($port in @(53, 88, 135, 389, 445, 8443)) {
|
||||||
|
if (-not (Test-TcpPort -Address $DomainControllerIPv4Address -Port $port -TimeoutMilliseconds 2000)) {
|
||||||
|
throw "Server $DomainControllerIPv4Address is reachable, but required TCP port $port is unavailable. Check AD/SGU services and the LAN/VPN firewall. Domain join has not started."
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
$certificateSubject = "CN=SGU Credential Provider Client $env:COMPUTERNAME"
|
$certificateSubject = "CN=SGU Credential Provider Client $env:COMPUTERNAME"
|
||||||
$clientCertificate = Get-ChildItem Cert:\LocalMachine\My |
|
$clientCertificate = Get-ChildItem Cert:\LocalMachine\My |
|
||||||
@@ -269,11 +934,16 @@ try {
|
|||||||
DomainCredential = $DomainCredential
|
DomainCredential = $DomainCredential
|
||||||
DomainName = $DomainName
|
DomainName = $DomainName
|
||||||
DomainNetbios = $DomainNetbios
|
DomainNetbios = $DomainNetbios
|
||||||
|
DomainControllerDnsName = "$($serverIdentity.ComputerName).$DomainName"
|
||||||
ComputerOuDn = $ComputerOuDn
|
ComputerOuDn = $ComputerOuDn
|
||||||
NetworkInterfaceAlias = $NetworkInterfaceAlias
|
NetworkInterfaceAlias = $NetworkInterfaceAlias
|
||||||
DomainDnsServerAddresses = @($DomainControllerIPv4Address.IPAddressToString)
|
DomainDnsServerAddresses = @($DomainControllerIPv4Address.IPAddressToString)
|
||||||
|
DomainDnsConfigured = $true
|
||||||
|
ConnectivityMode = $ConnectivityMode
|
||||||
RemoteDesktopPrincipal = "$DomainNetbios\SG-Laboratorio-Usuarios-RDP"
|
RemoteDesktopPrincipal = "$DomainNetbios\SG-Laboratorio-Usuarios-RDP"
|
||||||
DotNetRuntimeInstallerPath = $runtimeInstaller.FullName
|
DotNetRuntimeInstallerPath = $runtimeInstaller.FullName
|
||||||
|
RustDeskServerAddress = $serverIdentity.RustDeskServerAddress
|
||||||
|
RustDeskServerPublicKey = $serverIdentity.RustDeskPublicKey
|
||||||
SkipRestart = $true
|
SkipRestart = $true
|
||||||
}
|
}
|
||||||
if ($NewComputerName) {
|
if ($NewComputerName) {
|
||||||
@@ -281,6 +951,31 @@ try {
|
|||||||
}
|
}
|
||||||
|
|
||||||
$result = & (Join-Path $scriptsRoot 'Enroll-SguDomainClient.ps1') @enrollmentParameters
|
$result = & (Join-Path $scriptsRoot 'Enroll-SguDomainClient.ps1') @enrollmentParameters
|
||||||
|
|
||||||
|
$rustDeskEnrollment = $result.RustDesk
|
||||||
|
if (-not $rustDeskEnrollment -or -not $rustDeskEnrollment.RustDeskId -or
|
||||||
|
-not $rustDeskEnrollment.AccessPassword) {
|
||||||
|
throw 'The client RustDesk enrollment did not provide an ID and protected access credential.'
|
||||||
|
}
|
||||||
|
$rustDeskPasswordPointer = [Runtime.InteropServices.Marshal]::SecureStringToBSTR(
|
||||||
|
$rustDeskEnrollment.AccessPassword)
|
||||||
|
try {
|
||||||
|
$rustDeskPassword = [Runtime.InteropServices.Marshal]::PtrToStringBSTR($rustDeskPasswordPointer)
|
||||||
|
Invoke-Command -Session $session -ScriptBlock {
|
||||||
|
param($ComputerName, $RustDeskId, $AccessPassword)
|
||||||
|
$registrationScript = Join-Path $env:ProgramData 'SGU\RustDesk\Register-SguRustDeskDevice.ps1'
|
||||||
|
if (-not (Test-Path -LiteralPath $registrationScript -PathType Leaf)) {
|
||||||
|
throw 'The RustDesk device-registration script is missing on the domain controller.'
|
||||||
|
}
|
||||||
|
& $registrationScript -ComputerName $ComputerName -RustDeskId $RustDeskId `
|
||||||
|
-AccessPassword $AccessPassword | Out-Null
|
||||||
|
} -ArgumentList $env:COMPUTERNAME,$rustDeskEnrollment.RustDeskId,$rustDeskPassword
|
||||||
|
}
|
||||||
|
finally {
|
||||||
|
[Runtime.InteropServices.Marshal]::ZeroFreeBSTR($rustDeskPasswordPointer)
|
||||||
|
$rustDeskPassword = $null
|
||||||
|
}
|
||||||
|
$rustDeskEnrollment.PSObject.Properties.Remove('AccessPassword')
|
||||||
}
|
}
|
||||||
finally {
|
finally {
|
||||||
if ($session) {
|
if ($session) {
|
||||||
@@ -305,10 +1000,12 @@ finally {
|
|||||||
Set-Item WSMan:\localhost\Client\TrustedHosts -Value $priorTrustedHosts -Force
|
Set-Item WSMan:\localhost\Client\TrustedHosts -Value $priorTrustedHosts -Force
|
||||||
}
|
}
|
||||||
if (-not $winRmWasRunning) {
|
if (-not $winRmWasRunning) {
|
||||||
Stop-Service WinRM -Force -ErrorAction SilentlyContinue
|
Stop-Service WinRM -Force -NoWait -WarningAction SilentlyContinue `
|
||||||
|
-ErrorAction SilentlyContinue
|
||||||
}
|
}
|
||||||
Remove-Item -LiteralPath $temporaryRoot -Recurse -Force -ErrorAction SilentlyContinue
|
Remove-Item -LiteralPath $temporaryRoot -Recurse -Force -ErrorAction SilentlyContinue
|
||||||
$DomainCredential = $null
|
$DomainCredential = $null
|
||||||
|
$VpnClientCertificatePfxPassword = $null
|
||||||
}
|
}
|
||||||
|
|
||||||
if ($SkipRestart) {
|
if ($SkipRestart) {
|
||||||
@@ -318,7 +1015,13 @@ if ($SkipRestart) {
|
|||||||
ProviderInstalled = $true
|
ProviderInstalled = $true
|
||||||
ClientCertificateRegistered = $true
|
ClientCertificateRegistered = $true
|
||||||
BrokerEndpoint = $brokerEndpoint
|
BrokerEndpoint = $brokerEndpoint
|
||||||
|
ConnectivityMode = $ConnectivityMode
|
||||||
|
CompatibilityProfile = $CompatibilityProfile
|
||||||
|
VpnConnectionName = if ($ConnectivityMode -eq 'AzureP2S') { $VpnConnectionName } else { $null }
|
||||||
|
FsLogixInstalled = [bool]($fsLogixResult -and $fsLogixResult.Installed)
|
||||||
|
FsLogixChanged = [bool]($fsLogixResult -and $fsLogixResult.Changed)
|
||||||
RestartRequired = $true
|
RestartRequired = $true
|
||||||
|
RustDesk = if ($result) { $result.RustDesk } else { $null }
|
||||||
EnrollmentResult = $result
|
EnrollmentResult = $result
|
||||||
}
|
}
|
||||||
return
|
return
|
||||||
|
|||||||
@@ -0,0 +1,111 @@
|
|||||||
|
#Requires -Version 5.1
|
||||||
|
[CmdletBinding()]
|
||||||
|
param(
|
||||||
|
[string]$MonitoringRoot = 'C:\ProgramData\SGU\Monitoring',
|
||||||
|
[string]$ComputerOuDn = 'OU=Laboratorio,DC=lci,DC=lasalle,DC=mx',
|
||||||
|
[ValidateRange(30, 730)]
|
||||||
|
[int]$RetentionDays = 183,
|
||||||
|
[string]$BrokerEventLogName = 'SGU Auth Broker',
|
||||||
|
[switch]$InventoryOnly
|
||||||
|
)
|
||||||
|
|
||||||
|
$ErrorActionPreference = 'Stop'
|
||||||
|
Import-Module ActiveDirectory -ErrorAction Stop
|
||||||
|
|
||||||
|
foreach ($serviceName in 'EventLog','Wecsvc') {
|
||||||
|
Set-Service -Name $serviceName -StartupType Automatic
|
||||||
|
if ((Get-Service $serviceName).Status -ne 'Running') {
|
||||||
|
Start-Service $serviceName
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
$archiveRoot = Join-Path $MonitoringRoot 'Archive'
|
||||||
|
$brokerArchiveRoot = Join-Path $archiveRoot 'Broker'
|
||||||
|
$reportRoot = Join-Path $MonitoringRoot 'Reports'
|
||||||
|
New-Item -ItemType Directory -Path $archiveRoot,$brokerArchiveRoot,$reportRoot -Force | Out-Null
|
||||||
|
|
||||||
|
function Test-TcpEndpoint {
|
||||||
|
param(
|
||||||
|
[Parameter(Mandatory)][string]$ComputerName,
|
||||||
|
[int]$Port = 5985,
|
||||||
|
[int]$TimeoutMilliseconds = 900
|
||||||
|
)
|
||||||
|
|
||||||
|
$client = [Net.Sockets.TcpClient]::new()
|
||||||
|
try {
|
||||||
|
$pending = $client.BeginConnect($ComputerName, $Port, $null, $null)
|
||||||
|
if (-not $pending.AsyncWaitHandle.WaitOne($TimeoutMilliseconds)) {
|
||||||
|
return $false
|
||||||
|
}
|
||||||
|
$client.EndConnect($pending)
|
||||||
|
return $true
|
||||||
|
}
|
||||||
|
catch {
|
||||||
|
return $false
|
||||||
|
}
|
||||||
|
finally {
|
||||||
|
$client.Dispose()
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
if (-not $InventoryOnly) {
|
||||||
|
$forwardedLog = Get-WinEvent -ListLog ForwardedEvents -ErrorAction Stop
|
||||||
|
if ($forwardedLog.RecordCount -gt 0) {
|
||||||
|
$archivePath = Join-Path $archiveRoot ("ForwardedEvents-{0:yyyyMMdd-HHmmss}.evtx" -f (Get-Date))
|
||||||
|
& wevtutil.exe clear-log ForwardedEvents "/backup:$archivePath"
|
||||||
|
if ($LASTEXITCODE -ne 0) {
|
||||||
|
throw "Could not archive ForwardedEvents; wevtutil returned exit code $LASTEXITCODE."
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
$brokerLog = Get-WinEvent -ListLog $BrokerEventLogName -ErrorAction SilentlyContinue
|
||||||
|
if ($brokerLog -and $brokerLog.RecordCount -gt 0) {
|
||||||
|
$brokerArchivePath = Join-Path $brokerArchiveRoot ("SguAuthBroker-{0:yyyyMMdd-HHmmss}.evtx" -f (Get-Date))
|
||||||
|
& wevtutil.exe clear-log $BrokerEventLogName "/backup:$brokerArchivePath"
|
||||||
|
if ($LASTEXITCODE -ne 0) {
|
||||||
|
throw "Could not archive $BrokerEventLogName; wevtutil returned exit code $LASTEXITCODE."
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
$cutoff = (Get-Date).AddDays(-$RetentionDays)
|
||||||
|
Get-ChildItem -LiteralPath $archiveRoot -Filter '*.evtx' -File -Recurse -ErrorAction SilentlyContinue |
|
||||||
|
Where-Object LastWriteTime -lt $cutoff |
|
||||||
|
ForEach-Object { Remove-Item -LiteralPath $_.FullName -Force }
|
||||||
|
}
|
||||||
|
|
||||||
|
$computers = @(Get-ADComputer -SearchBase $ComputerOuDn -SearchScope Subtree -Filter * `
|
||||||
|
-Properties DNSHostName,IPv4Address,OperatingSystem,LastLogonDate,Enabled |
|
||||||
|
Sort-Object Name)
|
||||||
|
|
||||||
|
$inventory = @(foreach ($computer in $computers) {
|
||||||
|
$target = if ($computer.DNSHostName) { $computer.DNSHostName } else { $computer.Name }
|
||||||
|
$online = Test-TcpEndpoint -ComputerName $target
|
||||||
|
[pscustomobject]@{
|
||||||
|
ComputerName = $computer.Name
|
||||||
|
DNSHostName = $computer.DNSHostName
|
||||||
|
IPv4Address = $computer.IPv4Address
|
||||||
|
OperatingSystem = $computer.OperatingSystem
|
||||||
|
Enabled = [bool]$computer.Enabled
|
||||||
|
Status = if ($online) { 'Encendida' } else { 'Apagada o inaccesible' }
|
||||||
|
WinRMReachable = [bool]$online
|
||||||
|
LastDomainLogon = if ($computer.LastLogonDate) {
|
||||||
|
$computer.LastLogonDate.ToUniversalTime().ToString('o')
|
||||||
|
} else { $null }
|
||||||
|
CheckedAt = (Get-Date).ToUniversalTime().ToString('o')
|
||||||
|
}
|
||||||
|
})
|
||||||
|
|
||||||
|
$jsonPath = Join-Path $reportRoot 'machine-status.json'
|
||||||
|
$csvPath = Join-Path $reportRoot 'machine-status.csv'
|
||||||
|
[IO.File]::WriteAllText($jsonPath, (ConvertTo-Json -InputObject $inventory -Depth 4), [Text.UTF8Encoding]::new($false))
|
||||||
|
$inventory | Export-Csv -LiteralPath $csvPath -NoTypeInformation -Encoding UTF8
|
||||||
|
|
||||||
|
[pscustomobject]@{
|
||||||
|
CheckedAt = (Get-Date).ToUniversalTime().ToString('o')
|
||||||
|
ComputerCount = @($inventory).Count
|
||||||
|
OnlineCount = @($inventory | Where-Object WinRMReachable).Count
|
||||||
|
OfflineCount = @($inventory | Where-Object { -not $_.WinRMReachable }).Count
|
||||||
|
RetentionDays = $RetentionDays
|
||||||
|
StatusJson = $jsonPath
|
||||||
|
StatusCsv = $csvPath
|
||||||
|
}
|
||||||
@@ -0,0 +1,90 @@
|
|||||||
|
[CmdletBinding()]
|
||||||
|
param(
|
||||||
|
[Parameter(Mandatory)]
|
||||||
|
[string]$DataRoot,
|
||||||
|
|
||||||
|
[Parameter(Mandatory)]
|
||||||
|
[ValidatePattern('^[A-Fa-f0-9]{40}$')]
|
||||||
|
[string]$CertificateThumbprint
|
||||||
|
)
|
||||||
|
|
||||||
|
$ErrorActionPreference = 'Stop'
|
||||||
|
$requestsRoot = Join-Path $DataRoot 'Public\Requests'
|
||||||
|
$archiveRoot = Join-Path $DataRoot 'Public\Archive'
|
||||||
|
$rejectedRoot = Join-Path $DataRoot 'Public\Rejected'
|
||||||
|
$registrationScript = Join-Path $env:ProgramData 'SGU\RustDesk\Register-SguRustDeskDevice.ps1'
|
||||||
|
|
||||||
|
function Write-Result {
|
||||||
|
param(
|
||||||
|
[Parameter(Mandatory)][string]$RequestId,
|
||||||
|
[Parameter(Mandatory)][hashtable]$Value
|
||||||
|
)
|
||||||
|
$path = Join-Path $requestsRoot "$RequestId.result.json"
|
||||||
|
[IO.File]::WriteAllText($path, ($Value | ConvertTo-Json), [Text.UTF8Encoding]::new($false))
|
||||||
|
}
|
||||||
|
|
||||||
|
function Get-ComputerNameFromOwner {
|
||||||
|
param([Parameter(Mandatory)][string]$Owner)
|
||||||
|
if ($Owner -notmatch '^[^\\]+\\(?<Name>[A-Za-z0-9][A-Za-z0-9-]{0,62})\$$') {
|
||||||
|
throw 'The request file owner is not an Active Directory computer account.'
|
||||||
|
}
|
||||||
|
return $Matches.Name.ToUpperInvariant()
|
||||||
|
}
|
||||||
|
|
||||||
|
if (-not (Test-Path -LiteralPath $registrationScript -PathType Leaf)) {
|
||||||
|
throw "The RustDesk inventory registration script is missing: $registrationScript"
|
||||||
|
}
|
||||||
|
Import-Module ActiveDirectory -ErrorAction Stop
|
||||||
|
$certificate = Get-Item -LiteralPath "Cert:\LocalMachine\My\$CertificateThumbprint" -ErrorAction Stop
|
||||||
|
$rsa = [System.Security.Cryptography.X509Certificates.RSACertificateExtensions]::GetRSAPrivateKey($certificate)
|
||||||
|
if (-not $rsa) {
|
||||||
|
throw 'The Linux RustDesk enrollment certificate does not have an RSA private key.'
|
||||||
|
}
|
||||||
|
|
||||||
|
New-Item -ItemType Directory -Path $requestsRoot, $archiveRoot, $rejectedRoot -Force | Out-Null
|
||||||
|
Get-ChildItem -LiteralPath $requestsRoot -Filter '*.request' -File | ForEach-Object {
|
||||||
|
$requestFile = $_
|
||||||
|
$requestIdMatch = [regex]::Match($requestFile.BaseName,
|
||||||
|
'(?<Id>[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$')
|
||||||
|
if (-not $requestIdMatch.Success) {
|
||||||
|
Move-Item -LiteralPath $requestFile.FullName -Destination (Join-Path $rejectedRoot $requestFile.Name) -Force
|
||||||
|
return
|
||||||
|
}
|
||||||
|
$requestId = $requestIdMatch.Groups['Id'].Value
|
||||||
|
try {
|
||||||
|
$ownerComputerName = Get-ComputerNameFromOwner -Owner (Get-Acl -LiteralPath $requestFile.FullName).Owner
|
||||||
|
$plainText = [Text.Encoding]::UTF8.GetString($rsa.Decrypt(
|
||||||
|
[IO.File]::ReadAllBytes($requestFile.FullName),
|
||||||
|
[Security.Cryptography.RSAEncryptionPadding]::OaepSHA256))
|
||||||
|
$request = $plainText | ConvertFrom-Json -ErrorAction Stop
|
||||||
|
$computerName = [string]$request.ComputerName
|
||||||
|
$rustDeskId = [string]$request.RustDeskId
|
||||||
|
$accessPassword = [string]$request.AccessPassword
|
||||||
|
$declaredRequestId = [string]$request.RequestId
|
||||||
|
if ($computerName -notmatch '^[A-Za-z0-9][A-Za-z0-9-]{0,62}$' -or
|
||||||
|
$computerName.ToUpperInvariant() -ne $ownerComputerName -or
|
||||||
|
$rustDeskId -notmatch '^\d+$' -or
|
||||||
|
$accessPassword.Length -lt 12 -or
|
||||||
|
$declaredRequestId -notmatch '^[0-9a-fA-F-]{36}$') {
|
||||||
|
throw 'The encrypted Linux RustDesk registration payload is invalid.'
|
||||||
|
}
|
||||||
|
Get-ADComputer -Identity $ownerComputerName -ErrorAction Stop | Out-Null
|
||||||
|
& $registrationScript -ComputerName $ownerComputerName -RustDeskId $rustDeskId `
|
||||||
|
-AccessPassword $accessPassword -Confirm:$false | Out-Null
|
||||||
|
Write-Result -RequestId $declaredRequestId -Value @{
|
||||||
|
Status = 'Registered'
|
||||||
|
ComputerName = $ownerComputerName
|
||||||
|
RustDeskId = $rustDeskId
|
||||||
|
RegisteredAt = (Get-Date).ToString('o')
|
||||||
|
}
|
||||||
|
Move-Item -LiteralPath $requestFile.FullName -Destination (Join-Path $archiveRoot $requestFile.Name) -Force
|
||||||
|
}
|
||||||
|
catch {
|
||||||
|
$safeError = $_.Exception.Message -replace '(?i)password[^\r\n]*', 'credential validation failed'
|
||||||
|
Write-Result -RequestId $requestId -Value @{
|
||||||
|
Status = 'Rejected'
|
||||||
|
Error = $safeError
|
||||||
|
}
|
||||||
|
Move-Item -LiteralPath $requestFile.FullName -Destination (Join-Path $rejectedRoot $requestFile.Name) -Force -ErrorAction SilentlyContinue
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,57 @@
|
|||||||
|
# Called by the existing provider-update GPO, after its verified installer.
|
||||||
|
[CmdletBinding()]
|
||||||
|
param()
|
||||||
|
$ErrorActionPreference = 'Stop'
|
||||||
|
$computer = Get-CimInstance Win32_ComputerSystem
|
||||||
|
if (-not $computer.PartOfDomain -or $computer.DomainRole -ne 1) { return }
|
||||||
|
$id = '{D789CFD8-5AD4-489F-9B83-7EB5D9D09335}'
|
||||||
|
$provider = Get-Item "HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\Authentication\Credential Providers\$id" -ErrorAction SilentlyContinue
|
||||||
|
$com = Get-Item "HKLM:\SOFTWARE\Classes\CLSID\$id\InprocServer32" -ErrorAction SilentlyContinue
|
||||||
|
$default = (Get-ItemProperty 'HKLM:\SOFTWARE\Policies\Microsoft\Windows\System' -Name DefaultCredentialProvider -ErrorAction SilentlyContinue).DefaultCredentialProvider
|
||||||
|
$services = @(Get-Service WinRM,TermService -ErrorAction SilentlyContinue)
|
||||||
|
$ready = $provider -and $provider.GetValue('') -eq 'Acceso Institucional' -and $com -and $com.GetValue('') -and
|
||||||
|
(Test-Path -LiteralPath $com.GetValue('')) -and $default -eq $id -and
|
||||||
|
(Test-Path "$env:ProgramData\SGU\CredentialProvider\settings.json") -and
|
||||||
|
$services.Count -eq 2 -and @($services | Where-Object Status -ne Running).Count -eq 0
|
||||||
|
$root = Join-Path $env:ProgramData 'LCI-Admin\PolicyConsolidation'
|
||||||
|
$changed = [Collections.Generic.List[string]]::new()
|
||||||
|
function Disable-OwnedTask([string]$Name) {
|
||||||
|
$task = Get-ScheduledTask -TaskPath '\' -TaskName $Name -ErrorAction SilentlyContinue
|
||||||
|
if (-not $task -or -not $task.Settings.Enabled) { return }
|
||||||
|
# Preserve XML and installed files. Never interrupt an installation in flight.
|
||||||
|
if ($task.State -eq 'Running') { Write-Warning "Retirement deferred while $Name runs."; return }
|
||||||
|
if (-not (Test-Path -LiteralPath $root)) { New-Item $root -ItemType Directory -Force | Out-Null }
|
||||||
|
$backup = Join-Path $root ($Name+'.before.xml')
|
||||||
|
if (-not (Test-Path -LiteralPath $backup)) { Export-ScheduledTask -InputObject $task | Set-Content -LiteralPath $backup -Encoding Unicode }
|
||||||
|
Disable-ScheduledTask -InputObject $task | Out-Null
|
||||||
|
$changed.Add($Name)
|
||||||
|
}
|
||||||
|
if ($ready) {
|
||||||
|
# Preserve the enrollment guard until its other features are present.
|
||||||
|
$enrollmentPath = Join-Path $env:ProgramData 'SGU\Enrollment\enrollment.json'
|
||||||
|
$rustDeskReady = $true
|
||||||
|
if (Test-Path -LiteralPath $enrollmentPath) {
|
||||||
|
$enrollment = [IO.File]::ReadAllText($enrollmentPath) | ConvertFrom-Json
|
||||||
|
if ($enrollment.RustDeskServerAddress) { $rustDeskReady = (Get-Service RustDesk -ErrorAction SilentlyContinue).Status -eq 'Running' }
|
||||||
|
}
|
||||||
|
$forwardingReady = Test-Path 'HKLM:\SOFTWARE\Policies\Microsoft\Windows\EventLog\EventForwarding\SubscriptionManager'
|
||||||
|
if ($rustDeskReady -and $forwardingReady) {
|
||||||
|
Disable-OwnedTask 'SGU-CredentialProvider-EnrollmentGuard'
|
||||||
|
$guard = Get-ScheduledTask -TaskName 'SGU-CredentialProvider-EnrollmentGuard' -ErrorAction SilentlyContinue
|
||||||
|
if (-not $guard -or -not $guard.Settings.Enabled) {
|
||||||
|
$key = 'HKLM:\SOFTWARE\Policies\LaSalle\ClientMaintenance'
|
||||||
|
if (-not (Test-Path $key)) { New-Item $key -Force | Out-Null }
|
||||||
|
if ((Get-ItemProperty $key -Name ProviderManagedByGpo -ErrorAction SilentlyContinue).ProviderManagedByGpo -ne 1) {
|
||||||
|
New-ItemProperty $key -Name ProviderManagedByGpo -Value 1 -PropertyType DWord -Force | Out-Null
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
# The global SYSTEMCENTER GPO owns installation/repair from now on.
|
||||||
|
$canonical = Get-ScheduledTask -TaskName 'LCI-ConfigMgr2509-ClientRegistration' -ErrorAction SilentlyContinue
|
||||||
|
if ($canonical -and $canonical.Settings.Enabled -and $canonical.Actions.Arguments -match 'SYSTEMCENTER\.lci\.lasalle\.mx.+Ensure-CMCurrentClient\.ps1') {
|
||||||
|
Disable-OwnedTask 'CED Configuration Manager enrollment'
|
||||||
|
Disable-OwnedTask 'CED Configuration Manager policy enrollment'
|
||||||
|
}
|
||||||
|
if ((Get-Service HealthService -ErrorAction SilentlyContinue).Status -eq 'Running') { Disable-OwnedTask 'LCI-SCOM-AgentInstallNow' }
|
||||||
|
[pscustomobject]@{Computer=$env:COMPUTERNAME;ProviderReady=[bool]$ready;Disabled=@($changed.ToArray())}
|
||||||
@@ -0,0 +1,135 @@
|
|||||||
|
#Requires -Version 5.1
|
||||||
|
[CmdletBinding(SupportsShouldProcess)]
|
||||||
|
param([string]$DomainController = 'SGU-DC01.lci.lasalle.mx')
|
||||||
|
$ErrorActionPreference = 'Stop'
|
||||||
|
if ($env:COMPUTERNAME -ine $DomainController.Split('.')[0]) { throw 'Run on the specified primary DC so AD and SYSVOL are updated together.' }
|
||||||
|
Import-Module ActiveDirectory
|
||||||
|
Import-Module GroupPolicy
|
||||||
|
$domain = Get-ADDomain -Server $DomainController
|
||||||
|
$dn = $domain.DistinguishedName
|
||||||
|
$changes = [Collections.Generic.List[string]]::new()
|
||||||
|
$modified = @{}
|
||||||
|
$ids = @{
|
||||||
|
Wifi='0f62e905-dacb-4721-9f02-2e21423bb82e'
|
||||||
|
Provider='3b13538e-f7bf-4c26-9dd1-bf261a3378ae'
|
||||||
|
Remote='dddd0dcb-95f2-420a-bfbb-2e179c414ae4'
|
||||||
|
Experience='6332a4e0-2b6d-4b4c-8d88-0a758ba17fb3'
|
||||||
|
ConfigMgr='d882e45d-5e11-4460-98a3-d9ddc6d04bf3'
|
||||||
|
Scom='3437c619-254f-4afe-bbd5-5cbe23116c5d'
|
||||||
|
}
|
||||||
|
$roots = @{}
|
||||||
|
foreach ($key in $ids.Keys) {
|
||||||
|
Get-GPO -Guid $ids[$key] -Domain $domain.DNSRoot -Server $DomainController | Out-Null
|
||||||
|
$roots[$key] = Join-Path $env:WINDIR ("SYSVOL\domain\Policies\{"+$ids[$key]+'}')
|
||||||
|
}
|
||||||
|
function Set-PolicyText([string]$Owner,[string]$Relative,[string]$Text,[Text.Encoding]$Encoding=[Text.UTF8Encoding]::new($false)) {
|
||||||
|
$path = Join-Path $roots[$Owner] $Relative
|
||||||
|
if ((Test-Path -LiteralPath $path) -and [IO.File]::ReadAllText($path) -ceq $Text) { return }
|
||||||
|
if ($PSCmdlet.ShouldProcess($path,'Update consolidated policy file')) {
|
||||||
|
[IO.Directory]::CreateDirectory((Split-Path $path)) | Out-Null
|
||||||
|
[IO.File]::WriteAllText($path,$Text,$Encoding)
|
||||||
|
$modified[$Owner]=$true
|
||||||
|
$changes.Add("$Owner : $Relative")
|
||||||
|
}
|
||||||
|
}
|
||||||
|
foreach ($file in 'Install-SguCedWifiMaintenance.ps1','Repair-SguCedWifi.ps1','Set-SguCedClientNetwork.ps1','ced-network.json','Invoke-SguCedClientEnrollment.ps1') {
|
||||||
|
Set-PolicyText Wifi ('Machine\Scripts\Startup\'+$file) ([IO.File]::ReadAllText((Join-Path $PSScriptRoot $file)))
|
||||||
|
}
|
||||||
|
$wifiScript = "\\$($domain.DNSRoot)\SYSVOL\$($domain.DNSRoot)\Policies\{$($ids.Wifi)}\Machine\Scripts\Startup\Install-SguCedWifiMaintenance.ps1"
|
||||||
|
Set-PolicyText Wifi 'Machine\Scripts\scripts.ini' ("[Startup]`r`n0CmdLine=powershell.exe`r`n0Parameters=-NoProfile -NonInteractive -ExecutionPolicy Bypass -File `"$wifiScript`"`r`n") ([Text.Encoding]::Unicode)
|
||||||
|
|
||||||
|
# Keep the administrators helper and all UI/branding values in this GPO;
|
||||||
|
# remote-access configuration belongs exclusively to the domain-wide GPO.
|
||||||
|
$experienceIni = [IO.File]::ReadAllText((Join-Path $roots.Experience 'Machine\Scripts\scripts.ini'))
|
||||||
|
$startupSection = [regex]::Match($experienceIni,'(?ms)^\[Startup\]\r?\n(?<Body>.*?)(?=^\[|\z)')
|
||||||
|
if (-not $startupSection.Success) { throw 'Missing workstation-experience Startup section.' }
|
||||||
|
$entries = @([regex]::Matches($startupSection.Groups['Body'].Value,'(?m)^(\d+)CmdLine=(.*)\r?\n\1Parameters=(.*)\r?$'))
|
||||||
|
if (-not $entries.Count) { throw 'Unexpected workstation-experience startup registration.' }
|
||||||
|
$ini = "[Startup]`r`n"; $index=0
|
||||||
|
foreach ($entry in $entries) {
|
||||||
|
if ($entry.Groups[3].Value -match 'Enable-SguWorkstationRemoteAccess\.ps1') { continue }
|
||||||
|
$ini += "$($index)CmdLine=$($entry.Groups[2].Value.TrimEnd())`r`n$($index)Parameters=$($entry.Groups[3].Value.TrimEnd())`r`n"
|
||||||
|
$index++
|
||||||
|
}
|
||||||
|
$experienceUpdated = $experienceIni.Remove($startupSection.Index,$startupSection.Length).Insert($startupSection.Index,$ini)
|
||||||
|
Set-PolicyText Experience 'Machine\Scripts\scripts.ini' $experienceUpdated ([Text.Encoding]::Unicode)
|
||||||
|
$remoteIni = [IO.File]::ReadAllText((Join-Path $roots.Remote 'Machine\Scripts\scripts.ini'))
|
||||||
|
$remoteIni = $remoteIni -replace ' -LocalDnsServer [^\s]+','' -replace ' -FallbackDnsServer [^\s]+',''
|
||||||
|
Set-PolicyText Remote 'Machine\Scripts\scripts.ini' $remoteIni ([Text.Encoding]::Unicode)
|
||||||
|
Set-PolicyText Remote 'Machine\Scripts\Startup\Enable-SguWorkstationRemoteAccess.ps1' ([IO.File]::ReadAllText((Join-Path $PSScriptRoot 'Enable-SguWorkstationRemoteAccess.ps1')))
|
||||||
|
|
||||||
|
$providerIni = [IO.File]::ReadAllText((Join-Path $roots.Provider 'Machine\Scripts\scripts.ini'))
|
||||||
|
$match = [regex]::Match($providerIni,'Update-SguCredentialProvider-[0-9.]+\.ps1')
|
||||||
|
if (-not $match.Success) { throw 'Expected one existing verified provider updater.' }
|
||||||
|
$providerRelative = 'Machine\Scripts\Startup\'+$match.Value
|
||||||
|
$updater = [IO.File]::ReadAllText((Join-Path $roots.Provider $providerRelative))
|
||||||
|
$retirement = '& (Join-Path $PSScriptRoot ''Invoke-SguWorkstationConsolidation.ps1'') | Out-Null'
|
||||||
|
if ($updater -notmatch 'Invoke-SguWorkstationConsolidation') {
|
||||||
|
# Reuse the already pinned package/hash, certificates and version. A marker
|
||||||
|
# alone must not hide a missing COM binary or an obsolete display name.
|
||||||
|
$old = 'if (Test-Path -LiteralPath $markerPath -PathType Leaf) {'
|
||||||
|
$new = @'
|
||||||
|
$providerId = '{D789CFD8-5AD4-489F-9B83-7EB5D9D09335}'
|
||||||
|
$registered = Get-Item "HKLM:\SOFTWARE\Classes\CLSID\$providerId\InprocServer32" -ErrorAction SilentlyContinue
|
||||||
|
$display = Get-Item "HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\Authentication\Credential Providers\$providerId" -ErrorAction SilentlyContinue
|
||||||
|
$providerHealthy = $registered -and (Test-Path -LiteralPath $registered.GetValue('')) -and $display -and $display.GetValue('') -eq 'Acceso Institucional'
|
||||||
|
if ((Test-Path -LiteralPath $markerPath -PathType Leaf) -and $providerHealthy) {
|
||||||
|
& (Join-Path $PSScriptRoot 'Invoke-SguWorkstationConsolidation.ps1') | Out-Null
|
||||||
|
'@
|
||||||
|
if (-not $updater.Contains($old)) { throw 'Provider updater layout changed; inspect before merging.' }
|
||||||
|
$updater = $updater.Replace($old,$new)+"`r`n$retirement`r`n"
|
||||||
|
}
|
||||||
|
Set-PolicyText Provider $providerRelative $updater
|
||||||
|
Set-PolicyText Provider 'Machine\Scripts\Startup\Invoke-SguWorkstationConsolidation.ps1' ([IO.File]::ReadAllText((Join-Path $PSScriptRoot 'Invoke-SguWorkstationConsolidation.ps1')))
|
||||||
|
|
||||||
|
foreach ($owner in 'ConfigMgr','Scom') {
|
||||||
|
$relative = 'Machine\Preferences\ScheduledTasks\ScheduledTasks.xml'
|
||||||
|
[xml]$xml = [IO.File]::ReadAllText((Join-Path $roots[$owner] $relative))
|
||||||
|
$task = $xml.SelectSingleNode('//*[local-name()="Task"]')
|
||||||
|
$triggers = $task.SelectSingleNode('*[local-name()="Triggers"]')
|
||||||
|
if (-not $triggers -or $task.SelectSingleNode('.//*[local-name()="Arguments"]').InnerText -notmatch 'SYSTEMCENTER\.lci\.lasalle\.mx') { throw 'Unexpected agent deployment policy.' }
|
||||||
|
foreach ($time in @($triggers.SelectNodes('*[local-name()="TimeTrigger"]'))) { [void]$triggers.RemoveChild($time) }
|
||||||
|
if (-not $triggers.SelectSingleNode('*[local-name()="EventTrigger"]')) {
|
||||||
|
$event = $xml.CreateElement('EventTrigger',$task.NamespaceURI)
|
||||||
|
$enabled=$xml.CreateElement('Enabled',$task.NamespaceURI);$enabled.InnerText='true';[void]$event.AppendChild($enabled)
|
||||||
|
$subscription=$xml.CreateElement('Subscription',$task.NamespaceURI)
|
||||||
|
$subscription.InnerText='<QueryList><Query Id="0" Path="Microsoft-Windows-NetworkProfile/Operational"><Select Path="Microsoft-Windows-NetworkProfile/Operational">*[System[EventID=10000]]</Select></Query></QueryList>'
|
||||||
|
[void]$event.AppendChild($subscription)
|
||||||
|
$delay=$xml.CreateElement('Delay',$task.NamespaceURI);$delay.InnerText='PT1M';[void]$event.AppendChild($delay)
|
||||||
|
[void]$triggers.AppendChild($event)
|
||||||
|
}
|
||||||
|
$settings=$task.SelectSingleNode('*[local-name()="Settings"]')
|
||||||
|
if (-not $settings.SelectSingleNode('*[local-name()="RestartOnFailure"]')) {
|
||||||
|
$restart=$xml.CreateElement('RestartOnFailure',$task.NamespaceURI)
|
||||||
|
foreach ($pair in @(@('Interval','PT5M'),@('Count','2'))) {$child=$xml.CreateElement($pair[0],$task.NamespaceURI);$child.InnerText=$pair[1];[void]$restart.AppendChild($child)}
|
||||||
|
[void]$settings.AppendChild($restart)
|
||||||
|
}
|
||||||
|
# Ask Windows to validate the actual task schema before writing the GPP.
|
||||||
|
# TASK_VALIDATE_ONLY (1) never registers or launches a task.
|
||||||
|
$scheduler=New-Object -ComObject Schedule.Service
|
||||||
|
$scheduler.Connect()
|
||||||
|
[void]$scheduler.GetFolder('\').RegisterTask('LCI-Consolidation-SchemaValidation',$task.OuterXml,1,'SYSTEM',$null,5,$null)
|
||||||
|
Set-PolicyText $owner $relative $xml.OuterXml
|
||||||
|
}
|
||||||
|
|
||||||
|
foreach ($owner in @($modified.Keys)) {
|
||||||
|
$gpoDn="CN={$($ids[$owner])},CN=Policies,CN=System,$dn"
|
||||||
|
$ad=Get-ADObject $gpoDn -Server $DomainController -Properties versionNumber
|
||||||
|
$gpt=Join-Path $roots[$owner] 'GPT.INI'
|
||||||
|
$text=[IO.File]::ReadAllText($gpt)
|
||||||
|
$gptVersion=[long]([regex]::Match($text,'(?m)^Version=(\d+)\r?$').Groups[1].Value)
|
||||||
|
$base=[Math]::Max([long]$ad.versionNumber,$gptVersion)
|
||||||
|
$version=($base -band 0xFFFF0000L) -bor (($base+1) -band 0xFFFFL)
|
||||||
|
[IO.File]::WriteAllText($gpt,([regex]::Replace($text,'(?m)^Version=\d+\r?$',"Version=$version")),[Text.Encoding]::ASCII)
|
||||||
|
Set-ADObject $gpoDn -Server $DomainController -Replace @{versionNumber=[int]$version}
|
||||||
|
}
|
||||||
|
if ($PSCmdlet.ShouldProcess('CED - DNS de dominio','Align domain NRPT with the shared CED network configuration')) {
|
||||||
|
& (Join-Path $PSScriptRoot 'Set-SguCedDnsPolicy.ps1') -DomainController $DomainController | Out-Null
|
||||||
|
}
|
||||||
|
$configurationKey='HKLM\Software\Policies\LaSalle\CEDWifi'
|
||||||
|
$currentConfiguration=Get-GPRegistryValue -Guid $ids.Wifi -Domain $domain.DNSRoot -Server $DomainController -Key $configurationKey -ValueName ConfigurationVersion -ErrorAction SilentlyContinue
|
||||||
|
if ((-not $currentConfiguration -or $currentConfiguration.Value -ne 4) -and $PSCmdlet.ShouldProcess('CED - Wi-Fi de salas','Set configuration version 4')) {
|
||||||
|
Set-GPRegistryValue -Guid $ids.Wifi -Domain $domain.DNSRoot -Server $DomainController -Key $configurationKey -ValueName ConfigurationVersion -Type DWord -Value 4 | Out-Null
|
||||||
|
$changes.Add('Wifi : ConfigurationVersion=4')
|
||||||
|
}
|
||||||
|
[pscustomobject]@{Changed=($changes.Count -gt 0);Files=@($changes.ToArray());Gpos=@($modified.Keys);PrimaryController=$DomainController}
|
||||||
@@ -0,0 +1,89 @@
|
|||||||
|
#Requires -Version 5.1
|
||||||
|
[CmdletBinding(SupportsShouldProcess)]
|
||||||
|
param(
|
||||||
|
[Parameter(Mandatory)]
|
||||||
|
[ValidatePattern('^[A-Za-z0-9](?:[A-Za-z0-9-]{0,61}[A-Za-z0-9])?$')]
|
||||||
|
[string]$ClientName,
|
||||||
|
[string]$OutputDirectory = (Join-Path $PSScriptRoot '..\artifacts\azure-p2s'),
|
||||||
|
[securestring]$ClientPfxPassword,
|
||||||
|
[string]$RootSubject = 'CN=SGU Azure P2S Root',
|
||||||
|
[ValidateRange(1, 10)]
|
||||||
|
[int]$ClientValidityYears = 2,
|
||||||
|
[switch]$Force
|
||||||
|
)
|
||||||
|
|
||||||
|
$ErrorActionPreference = 'Stop'
|
||||||
|
$resolvedOutputDirectory = [IO.Path]::GetFullPath($OutputDirectory)
|
||||||
|
New-Item -ItemType Directory -Path $resolvedOutputDirectory -Force | Out-Null
|
||||||
|
$rootCertificatePath = Join-Path $resolvedOutputDirectory 'sgu-azure-p2s-root.cer'
|
||||||
|
$clientCertificatePath = Join-Path $resolvedOutputDirectory "sgu-azure-p2s-$ClientName.pfx"
|
||||||
|
if ((Test-Path -LiteralPath $clientCertificatePath -PathType Leaf) -and -not $Force) {
|
||||||
|
throw "$clientCertificatePath already exists. Use -Force only when you intend to replace that exported client credential."
|
||||||
|
}
|
||||||
|
|
||||||
|
if (-not $ClientPfxPassword) {
|
||||||
|
$ClientPfxPassword = Read-Host 'Password that will protect the exported P2S client certificate' -AsSecureString
|
||||||
|
}
|
||||||
|
|
||||||
|
$rootCertificate = Get-ChildItem Cert:\CurrentUser\My |
|
||||||
|
Where-Object {
|
||||||
|
$_.Subject -eq $RootSubject -and
|
||||||
|
$_.HasPrivateKey -and
|
||||||
|
$_.NotAfter -gt (Get-Date).AddYears($ClientValidityYears)
|
||||||
|
} |
|
||||||
|
Sort-Object NotAfter -Descending |
|
||||||
|
Select-Object -First 1
|
||||||
|
|
||||||
|
if (-not $rootCertificate) {
|
||||||
|
if (-not $PSCmdlet.ShouldProcess($RootSubject, 'Create a non-exportable Azure P2S root certificate authority')) {
|
||||||
|
return
|
||||||
|
}
|
||||||
|
$rootCertificate = New-SelfSignedCertificate `
|
||||||
|
-Type Custom `
|
||||||
|
-Subject $RootSubject `
|
||||||
|
-CertStoreLocation Cert:\CurrentUser\My `
|
||||||
|
-KeyAlgorithm RSA `
|
||||||
|
-KeyLength 4096 `
|
||||||
|
-HashAlgorithm SHA256 `
|
||||||
|
-KeySpec Signature `
|
||||||
|
-KeyExportPolicy NonExportable `
|
||||||
|
-KeyUsage CertSign,CRLSign,DigitalSignature `
|
||||||
|
-NotAfter (Get-Date).AddYears(10) `
|
||||||
|
-TextExtension @('2.5.29.19={critical}{text}ca=1&pathlength=1')
|
||||||
|
}
|
||||||
|
|
||||||
|
if (-not $PSCmdlet.ShouldProcess($ClientName, 'Issue and export an Azure P2S machine certificate')) {
|
||||||
|
return
|
||||||
|
}
|
||||||
|
|
||||||
|
$clientSubject = "CN=SGU Azure P2S $ClientName"
|
||||||
|
$clientCertificate = New-SelfSignedCertificate `
|
||||||
|
-Type Custom `
|
||||||
|
-Subject $clientSubject `
|
||||||
|
-DnsName "sgu-p2s-$ClientName" `
|
||||||
|
-Signer $rootCertificate `
|
||||||
|
-CertStoreLocation Cert:\CurrentUser\My `
|
||||||
|
-KeyAlgorithm RSA `
|
||||||
|
-KeyLength 3072 `
|
||||||
|
-HashAlgorithm SHA256 `
|
||||||
|
-KeySpec Signature `
|
||||||
|
-KeyExportPolicy Exportable `
|
||||||
|
-KeyUsage DigitalSignature `
|
||||||
|
-NotAfter (Get-Date).AddYears($ClientValidityYears) `
|
||||||
|
-TextExtension @('2.5.29.37={text}1.3.6.1.5.5.7.3.2')
|
||||||
|
|
||||||
|
Export-Certificate -Cert $rootCertificate -FilePath $rootCertificatePath -Force | Out-Null
|
||||||
|
Export-PfxCertificate -Cert $clientCertificate -FilePath $clientCertificatePath `
|
||||||
|
-Password $ClientPfxPassword -ChainOption BuildChain -CryptoAlgorithmOption AES256_SHA256 `
|
||||||
|
-Force | Out-Null
|
||||||
|
|
||||||
|
[pscustomobject]@{
|
||||||
|
RootCertificatePath = $rootCertificatePath
|
||||||
|
RootCertificateThumbprint = $rootCertificate.Thumbprint
|
||||||
|
RootCertificateData = [Convert]::ToBase64String($rootCertificate.RawData)
|
||||||
|
ClientName = $ClientName
|
||||||
|
ClientCertificatePath = $clientCertificatePath
|
||||||
|
ClientCertificateThumbprint = $clientCertificate.Thumbprint
|
||||||
|
ClientCertificateExpires = $clientCertificate.NotAfter
|
||||||
|
RootPrivateKeyExportable = $false
|
||||||
|
}
|
||||||
@@ -33,7 +33,10 @@ function Write-PackageManifest {
|
|||||||
param(
|
param(
|
||||||
[Parameter(Mandatory)][string]$PackageRoot,
|
[Parameter(Mandatory)][string]$PackageRoot,
|
||||||
[Parameter(Mandatory)][string]$PackageVersion,
|
[Parameter(Mandatory)][string]$PackageVersion,
|
||||||
[Parameter(Mandatory)][string]$PackageKind
|
[Parameter(Mandatory)][string]$PackageKind,
|
||||||
|
[ValidateSet('Auto')]
|
||||||
|
[string]$CompatibilityProfile,
|
||||||
|
[string]$TargetOperatingSystem
|
||||||
)
|
)
|
||||||
|
|
||||||
$resolvedPackageRoot = (Resolve-Path -LiteralPath $PackageRoot).Path.TrimEnd('\')
|
$resolvedPackageRoot = (Resolve-Path -LiteralPath $PackageRoot).Path.TrimEnd('\')
|
||||||
@@ -48,13 +51,19 @@ function Write-PackageManifest {
|
|||||||
}
|
}
|
||||||
})
|
})
|
||||||
$manifest = [ordered]@{
|
$manifest = [ordered]@{
|
||||||
SchemaVersion = 1
|
SchemaVersion = 2
|
||||||
Product = 'SGU Credential Provider'
|
Product = 'SGU Credential Provider'
|
||||||
PackageKind = $PackageKind
|
PackageKind = $PackageKind
|
||||||
Version = $PackageVersion
|
Version = $PackageVersion
|
||||||
CreatedAt = (Get-Date).ToUniversalTime().ToString('o')
|
CreatedAt = (Get-Date).ToUniversalTime().ToString('o')
|
||||||
Files = $files
|
Files = $files
|
||||||
}
|
}
|
||||||
|
if ($CompatibilityProfile) {
|
||||||
|
$manifest['CompatibilityProfile'] = $CompatibilityProfile
|
||||||
|
}
|
||||||
|
if ($TargetOperatingSystem) {
|
||||||
|
$manifest['TargetOperatingSystem'] = $TargetOperatingSystem
|
||||||
|
}
|
||||||
[IO.File]::WriteAllText(
|
[IO.File]::WriteAllText(
|
||||||
(Join-Path $resolvedPackageRoot 'package-manifest.json'),
|
(Join-Path $resolvedPackageRoot 'package-manifest.json'),
|
||||||
($manifest | ConvertTo-Json -Depth 6),
|
($manifest | ConvertTo-Json -Depth 6),
|
||||||
@@ -78,17 +87,34 @@ if (-not $runtimeInstaller) {
|
|||||||
}
|
}
|
||||||
|
|
||||||
New-Item -ItemType Directory -Path $resolvedOutputRoot -Force | Out-Null
|
New-Item -ItemType Directory -Path $resolvedOutputRoot -Force | Out-Null
|
||||||
$clientRoot = Join-Path $resolvedOutputRoot "sgu-client-bootstrap-$Version"
|
$clientRoot = Join-Path $resolvedOutputRoot "sgu-windows-client-bootstrap-$Version"
|
||||||
$serverRoot = Join-Path $resolvedOutputRoot "sgu-server-bootstrap-$Version"
|
$serverRoot = Join-Path $resolvedOutputRoot "sgu-server-bootstrap-$Version"
|
||||||
|
$linuxClientRoot = Join-Path $resolvedOutputRoot "sgu-linux-client-bootstrap-$Version"
|
||||||
|
$azureRoot = Join-Path $resolvedOutputRoot "sgu-azure-infrastructure-$Version"
|
||||||
|
$wifiRoot = Join-Path $resolvedOutputRoot "sgu-ced-wifi-policy-$Version"
|
||||||
$clientZip = "$clientRoot.zip"
|
$clientZip = "$clientRoot.zip"
|
||||||
$serverZip = "$serverRoot.zip"
|
$serverZip = "$serverRoot.zip"
|
||||||
foreach ($target in @($clientRoot,$serverRoot,$clientZip,$serverZip)) {
|
$linuxClientZip = "$linuxClientRoot.zip"
|
||||||
|
$azureZip = "$azureRoot.zip"
|
||||||
|
$wifiZip = "$wifiRoot.zip"
|
||||||
|
foreach ($target in @(
|
||||||
|
$clientRoot,$serverRoot,$linuxClientRoot,$azureRoot,$wifiRoot,
|
||||||
|
$clientZip,$serverZip,$linuxClientZip,$azureZip,$wifiZip)) {
|
||||||
if (Test-Path -LiteralPath $target) {
|
if (Test-Path -LiteralPath $target) {
|
||||||
throw "Release target already exists: $target"
|
throw "Release target already exists: $target"
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
New-Item -ItemType Directory -Path $clientRoot,$serverRoot -Force | Out-Null
|
New-Item -ItemType Directory `
|
||||||
|
-Path $clientRoot,$serverRoot,$linuxClientRoot,$azureRoot,$wifiRoot `
|
||||||
|
-Force | Out-Null
|
||||||
|
$welcomeFontNames = @(
|
||||||
|
'IndivisaTextSans-Regular.otf',
|
||||||
|
'IndivisaTextSans-Bold.otf',
|
||||||
|
'IndivisaTextSans-BoldItalic.otf',
|
||||||
|
'IndivisaTextSerif-Regular.otf',
|
||||||
|
'IndivisaTextSerif-BoldItalic.otf'
|
||||||
|
)
|
||||||
|
|
||||||
Copy-RequiredFile -Source (Join-Path $PSScriptRoot 'Invoke-SguClientBootstrap.ps1') `
|
Copy-RequiredFile -Source (Join-Path $PSScriptRoot 'Invoke-SguClientBootstrap.ps1') `
|
||||||
-Destination (Join-Path $clientRoot 'Invoke-SguClientBootstrap.ps1')
|
-Destination (Join-Path $clientRoot 'Invoke-SguClientBootstrap.ps1')
|
||||||
@@ -96,11 +122,16 @@ Copy-RequiredFile -Source (Join-Path $PSScriptRoot 'Start-SguClientEnrollment.cm
|
|||||||
-Destination (Join-Path $clientRoot 'Start-SguClientEnrollment.cmd')
|
-Destination (Join-Path $clientRoot 'Start-SguClientEnrollment.cmd')
|
||||||
$clientScripts = @(
|
$clientScripts = @(
|
||||||
'Enable-LabRemoteAccess.ps1',
|
'Enable-LabRemoteAccess.ps1',
|
||||||
|
'Enable-SguClientMonitoring.ps1',
|
||||||
'Enroll-SguDomainClient.ps1',
|
'Enroll-SguDomainClient.ps1',
|
||||||
'Install-CredentialProvider.ps1',
|
'Install-CredentialProvider.ps1',
|
||||||
|
'Install-SguFsLogix.ps1',
|
||||||
'Install-SguEnrollmentGuard.ps1',
|
'Install-SguEnrollmentGuard.ps1',
|
||||||
|
'Install-SguRustDeskClient.ps1',
|
||||||
'Register-SguClientCertificate.ps1',
|
'Register-SguClientCertificate.ps1',
|
||||||
'Repair-SguClientEnrollment.ps1',
|
'Repair-SguClientEnrollment.ps1',
|
||||||
|
'Set-SguStandardLocalUser.ps1',
|
||||||
|
'Set-SguLocalProfileSecurityPolicies.ps1',
|
||||||
'Test-SguClientEnrollment.ps1'
|
'Test-SguClientEnrollment.ps1'
|
||||||
)
|
)
|
||||||
foreach ($scriptName in $clientScripts) {
|
foreach ($scriptName in $clientScripts) {
|
||||||
@@ -113,23 +144,109 @@ Copy-Item -Path (Join-Path $providerOutput '*') `
|
|||||||
-Recurse -Force
|
-Recurse -Force
|
||||||
Copy-RequiredFile -Source (Join-Path $repositoryRoot 'assets\branding\lasalle-mascot-account.png') `
|
Copy-RequiredFile -Source (Join-Path $repositoryRoot 'assets\branding\lasalle-mascot-account.png') `
|
||||||
-Destination (Join-Path $clientRoot 'payload\credential-provider\branding\user.png')
|
-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') `
|
||||||
|
-Destination (Join-Path $clientRoot 'payload\credential-provider\branding\Set-SguWelcomeWallpaper.ps1')
|
||||||
|
foreach ($fontName in $welcomeFontNames) {
|
||||||
|
Copy-RequiredFile -Source (Join-Path $repositoryRoot "assets\branding\fonts\$fontName") `
|
||||||
|
-Destination (Join-Path $clientRoot "payload\credential-provider\branding\fonts\$fontName")
|
||||||
|
}
|
||||||
Copy-RequiredFile -Source $runtimeInstaller.FullName `
|
Copy-RequiredFile -Source $runtimeInstaller.FullName `
|
||||||
-Destination (Join-Path $clientRoot "payload\prerequisites\$($runtimeInstaller.Name)")
|
-Destination (Join-Path $clientRoot "payload\prerequisites\$($runtimeInstaller.Name)")
|
||||||
Write-PackageManifest -PackageRoot $clientRoot -PackageVersion $Version -PackageKind Client
|
|
||||||
|
# One Windows implementation supports existing LAN/VPN routes and optional Azure P2S.
|
||||||
|
Copy-RequiredFile -Source (Join-Path $PSScriptRoot 'Start-SguAzureClientEnrollment.cmd') `
|
||||||
|
-Destination (Join-Path $clientRoot 'Start-SguAzureClientEnrollment.cmd')
|
||||||
|
Copy-RequiredFile -Source (Join-Path $PSScriptRoot 'Install-SguAzureP2sClient.ps1') `
|
||||||
|
-Destination (Join-Path $clientRoot 'Install-SguAzureP2sClient.ps1')
|
||||||
|
Copy-RequiredFile -Source (Join-Path $repositoryRoot 'docs\client-enrollment.md') `
|
||||||
|
-Destination (Join-Path $clientRoot 'README.md')
|
||||||
|
Copy-Item -Path (Join-Path $repositoryRoot 'docs\*.md') -Destination $clientRoot
|
||||||
|
|
||||||
|
Write-PackageManifest -PackageRoot $clientRoot -PackageVersion $Version `
|
||||||
|
-PackageKind WindowsClient -CompatibilityProfile Auto `
|
||||||
|
-TargetOperatingSystem 'Windows 10 1607+ or Windows 11; x64 Pro, Enterprise, or Education'
|
||||||
Compress-Archive -Path (Join-Path $clientRoot '*') -DestinationPath $clientZip `
|
Compress-Archive -Path (Join-Path $clientRoot '*') -DestinationPath $clientZip `
|
||||||
-CompressionLevel Optimal
|
-CompressionLevel Optimal
|
||||||
|
|
||||||
|
# Linux clients use their native PAM/SSSD sign-in stack rather than the Windows
|
||||||
|
# Credential Provider. Keep their self-contained bootstrap independent so a
|
||||||
|
# Linux administrator never receives Windows binaries or certificate material.
|
||||||
|
Copy-RequiredFile -Source (Join-Path $PSScriptRoot 'Enroll-SguLinuxDomainClient.sh') `
|
||||||
|
-Destination (Join-Path $linuxClientRoot 'Enroll-SguLinuxDomainClient.sh')
|
||||||
|
Copy-RequiredFile -Source (Join-Path $PSScriptRoot 'Install-SguLinuxRustDeskClient.sh') `
|
||||||
|
-Destination (Join-Path $linuxClientRoot 'Install-SguLinuxRustDeskClient.sh')
|
||||||
|
Copy-RequiredFile -Source (Join-Path $repositoryRoot 'docs\linux-client-enrollment.md') `
|
||||||
|
-Destination (Join-Path $linuxClientRoot 'README.md')
|
||||||
|
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")
|
||||||
|
}
|
||||||
|
Write-PackageManifest -PackageRoot $linuxClientRoot -PackageVersion $Version -PackageKind LinuxClient
|
||||||
|
Compress-Archive -Path (Join-Path $linuxClientRoot '*') -DestinationPath $linuxClientZip `
|
||||||
|
-CompressionLevel Optimal
|
||||||
|
|
||||||
Copy-RequiredFile -Source (Join-Path $PSScriptRoot 'Initialize-SguDomainController.ps1') `
|
Copy-RequiredFile -Source (Join-Path $PSScriptRoot 'Initialize-SguDomainController.ps1') `
|
||||||
-Destination (Join-Path $serverRoot 'Initialize-SguDomainController.ps1')
|
-Destination (Join-Path $serverRoot 'Initialize-SguDomainController.ps1')
|
||||||
Copy-RequiredFile -Source (Join-Path $PSScriptRoot 'Start-SguServerBootstrap.cmd') `
|
Copy-RequiredFile -Source (Join-Path $PSScriptRoot 'Start-SguServerBootstrap.cmd') `
|
||||||
-Destination (Join-Path $serverRoot 'Start-SguServerBootstrap.cmd')
|
-Destination (Join-Path $serverRoot 'Start-SguServerBootstrap.cmd')
|
||||||
|
Copy-RequiredFile -Source (Join-Path $PSScriptRoot 'Start-SguAzureServerBootstrap.cmd') `
|
||||||
|
-Destination (Join-Path $serverRoot 'Start-SguAzureServerBootstrap.cmd')
|
||||||
$serverScripts = @(
|
$serverScripts = @(
|
||||||
|
'Set-SguCedWifiPolicy.ps1',
|
||||||
|
'Set-SguCedClientNetwork.ps1',
|
||||||
|
'ced-network.json',
|
||||||
|
'Set-SguCedDnsPolicy.ps1',
|
||||||
|
'Invoke-SguWorkstationConsolidation.ps1',
|
||||||
|
'Merge-SguClientPolicies.ps1',
|
||||||
|
'Install-SguCedWifiMaintenance.ps1',
|
||||||
|
'Repair-SguCedWifi.ps1',
|
||||||
|
'Sync-SguCedWifiReaders.ps1',
|
||||||
|
'Connect-SguCedWifi.ps1',
|
||||||
|
'Invoke-SguCedClientEnrollment.ps1',
|
||||||
'Deploy-AuthBroker.ps1',
|
'Deploy-AuthBroker.ps1',
|
||||||
|
'Disable-SguAzureUserRoaming.ps1',
|
||||||
|
'Enable-SguAzureUserRoaming.ps1',
|
||||||
'Enable-SguServerRemoteManagement.ps1',
|
'Enable-SguServerRemoteManagement.ps1',
|
||||||
|
'Enable-SguWorkstationRemoteAccess.ps1',
|
||||||
|
'Enable-SguWorkstationAdministrators.ps1',
|
||||||
|
'Get-SguUsageReport.ps1',
|
||||||
|
'Get-SguBrokerLog.ps1',
|
||||||
|
'Install-SguDomainMonitoring.ps1',
|
||||||
|
'Install-SguWorkstationRemoteAccessPolicy.ps1',
|
||||||
|
'Install-SguDomainRemoteManagementPolicy.ps1',
|
||||||
|
'Sync-SguWacDomainConnections.ps1',
|
||||||
|
'Get-SguWorkstationRemoteManagementStatus.ps1',
|
||||||
|
'Publish-SguFsLogixClientDeployment.ps1',
|
||||||
|
'Install-SguRustDeskClient.ps1',
|
||||||
|
'Install-SguRustDeskLinuxEnrollment.ps1',
|
||||||
|
'Install-SguRustDeskServer.ps1',
|
||||||
|
'Invoke-SguRustDeskLinuxRegistrationProcessor.ps1',
|
||||||
|
'Invoke-SguMonitoringMaintenance.ps1',
|
||||||
'New-LabCertificate.ps1',
|
'New-LabCertificate.ps1',
|
||||||
|
'Get-SguRustDeskDevice.ps1',
|
||||||
'Register-SguClientCertificate.ps1',
|
'Register-SguClientCertificate.ps1',
|
||||||
|
'Register-SguRustDeskDevice.ps1',
|
||||||
'Set-LabBrokerDns.ps1',
|
'Set-LabBrokerDns.ps1',
|
||||||
|
'Set-SguInstitutionalPasswordPolicy.ps1',
|
||||||
'Set-SguDomainComputerPolicies.ps1',
|
'Set-SguDomainComputerPolicies.ps1',
|
||||||
|
'Set-SguLaboratorioWallpaperPolicy.ps1',
|
||||||
|
'Set-SguLocalProfileSecurityPolicies.ps1',
|
||||||
'Set-SguDomainUserPolicies.ps1'
|
'Set-SguDomainUserPolicies.ps1'
|
||||||
)
|
)
|
||||||
foreach ($scriptName in $serverScripts) {
|
foreach ($scriptName in $serverScripts) {
|
||||||
@@ -149,23 +266,100 @@ if ($ServerContentPath) {
|
|||||||
Copy-Item -Path (Join-Path $ServerContentPath '*') `
|
Copy-Item -Path (Join-Path $ServerContentPath '*') `
|
||||||
-Destination $serverContentTarget -Recurse -Force
|
-Destination $serverContentTarget -Recurse -Force
|
||||||
}
|
}
|
||||||
|
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) {
|
||||||
|
Copy-RequiredFile -Source (Join-Path $repositoryRoot "assets\branding\fonts\$fontName") `
|
||||||
|
-Destination (Join-Path $serverContentTarget "welcome-wallpaper\fonts\$fontName")
|
||||||
|
}
|
||||||
|
foreach ($documentation in @('user-roaming.md', 'laboratorio-wallpaper-policy.md','policy-consolidation.md')) {
|
||||||
|
Copy-RequiredFile -Source (Join-Path $repositoryRoot "docs\$documentation") `
|
||||||
|
-Destination (Join-Path $serverRoot "docs\$documentation")
|
||||||
|
}
|
||||||
Write-PackageManifest -PackageRoot $serverRoot -PackageVersion $Version -PackageKind Server
|
Write-PackageManifest -PackageRoot $serverRoot -PackageVersion $Version -PackageKind Server
|
||||||
Compress-Archive -Path (Join-Path $serverRoot '*') -DestinationPath $serverZip `
|
Compress-Archive -Path (Join-Path $serverRoot '*') -DestinationPath $serverZip `
|
||||||
-CompressionLevel Optimal
|
-CompressionLevel Optimal
|
||||||
|
|
||||||
|
# Azure infrastructure is packaged separately because it runs on the trusted
|
||||||
|
# administrator workstation, not inside the domain controller or a client.
|
||||||
|
$azureScriptsRoot = Join-Path $azureRoot 'scripts'
|
||||||
|
$azureInfrastructureRoot = Join-Path $azureRoot 'infra\azure'
|
||||||
|
New-Item -ItemType Directory -Path $azureScriptsRoot,$azureInfrastructureRoot -Force | Out-Null
|
||||||
|
Copy-RequiredFile -Source (Join-Path $repositoryRoot 'infra\azure\main.bicep') `
|
||||||
|
-Destination (Join-Path $azureInfrastructureRoot 'main.bicep')
|
||||||
|
foreach ($scriptName in @(
|
||||||
|
'New-SguAzureP2sCertificates.ps1',
|
||||||
|
'Deploy-SguAzureInfrastructure.ps1',
|
||||||
|
'Get-SguAzureP2sPackage.ps1',
|
||||||
|
'Install-SguAzureP2sClient.ps1')) {
|
||||||
|
Copy-RequiredFile -Source (Join-Path $PSScriptRoot $scriptName) `
|
||||||
|
-Destination (Join-Path $azureScriptsRoot $scriptName)
|
||||||
|
}
|
||||||
|
Copy-RequiredFile -Source (Join-Path $repositoryRoot 'docs\azure-vpn-deployment.md') `
|
||||||
|
-Destination (Join-Path $azureRoot 'README.md')
|
||||||
|
Copy-RequiredFile -Source (Join-Path $repositoryRoot 'docs\user-roaming.md') `
|
||||||
|
-Destination (Join-Path $azureRoot 'user-roaming.md')
|
||||||
|
Write-PackageManifest -PackageRoot $azureRoot -PackageVersion $Version -PackageKind AzureInfrastructure
|
||||||
|
Compress-Archive -Path (Join-Path $azureRoot '*') -DestinationPath $azureZip `
|
||||||
|
-CompressionLevel Optimal
|
||||||
|
|
||||||
|
# Existing domains can publish the WLAN correction without running forest setup.
|
||||||
|
foreach ($scriptName in @(
|
||||||
|
'Enable-SguWorkstationRemoteAccess.ps1',
|
||||||
|
'Set-SguCedWifiPolicy.ps1',
|
||||||
|
'Set-SguCedClientNetwork.ps1',
|
||||||
|
'ced-network.json',
|
||||||
|
'Set-SguCedDnsPolicy.ps1',
|
||||||
|
'Invoke-SguWorkstationConsolidation.ps1',
|
||||||
|
'Merge-SguClientPolicies.ps1',
|
||||||
|
'Install-SguCedWifiMaintenance.ps1',
|
||||||
|
'Repair-SguCedWifi.ps1',
|
||||||
|
'Sync-SguCedWifiReaders.ps1',
|
||||||
|
'Connect-SguCedWifi.ps1',
|
||||||
|
'Invoke-SguCedClientEnrollment.ps1')) {
|
||||||
|
Copy-RequiredFile -Source (Join-Path $PSScriptRoot $scriptName) `
|
||||||
|
-Destination (Join-Path $wifiRoot $scriptName)
|
||||||
|
}
|
||||||
|
Copy-RequiredFile -Source (Join-Path $repositoryRoot 'docs\ced-wifi-release.md') `
|
||||||
|
-Destination (Join-Path $wifiRoot 'README.md')
|
||||||
|
Copy-RequiredFile -Source (Join-Path $repositoryRoot 'docs\ced-network-operations.md') `
|
||||||
|
-Destination (Join-Path $wifiRoot 'ced-network-operations.md')
|
||||||
|
Copy-RequiredFile -Source (Join-Path $repositoryRoot 'docs\policy-consolidation.md') `
|
||||||
|
-Destination (Join-Path $wifiRoot 'policy-consolidation.md')
|
||||||
|
Write-PackageManifest -PackageRoot $wifiRoot -PackageVersion $Version -PackageKind CedWifiPolicy
|
||||||
|
Compress-Archive -Path (Join-Path $wifiRoot '*') -DestinationPath $wifiZip `
|
||||||
|
-CompressionLevel Optimal
|
||||||
|
|
||||||
$checksums = @(
|
$checksums = @(
|
||||||
("{0} {1}" -f (Get-FileHash -LiteralPath $clientZip -Algorithm SHA256).Hash, (Split-Path $clientZip -Leaf))
|
("{0} {1}" -f (Get-FileHash -LiteralPath $clientZip -Algorithm SHA256).Hash, (Split-Path $clientZip -Leaf))
|
||||||
("{0} {1}" -f (Get-FileHash -LiteralPath $serverZip -Algorithm SHA256).Hash, (Split-Path $serverZip -Leaf))
|
("{0} {1}" -f (Get-FileHash -LiteralPath $serverZip -Algorithm SHA256).Hash, (Split-Path $serverZip -Leaf))
|
||||||
|
("{0} {1}" -f (Get-FileHash -LiteralPath $linuxClientZip -Algorithm SHA256).Hash, (Split-Path $linuxClientZip -Leaf))
|
||||||
|
("{0} {1}" -f (Get-FileHash -LiteralPath $azureZip -Algorithm SHA256).Hash, (Split-Path $azureZip -Leaf))
|
||||||
|
("{0} {1}" -f (Get-FileHash -LiteralPath $wifiZip -Algorithm SHA256).Hash, (Split-Path $wifiZip -Leaf))
|
||||||
)
|
)
|
||||||
$checksumsPath = Join-Path $resolvedOutputRoot "SHA256SUMS-$Version.txt"
|
$checksumsPath = Join-Path $resolvedOutputRoot "SHA256SUMS-$Version.txt"
|
||||||
[IO.File]::WriteAllLines($checksumsPath, $checksums, [Text.UTF8Encoding]::new($false))
|
[IO.File]::WriteAllLines($checksumsPath, $checksums, [Text.UTF8Encoding]::new($false))
|
||||||
|
|
||||||
[pscustomobject]@{
|
[pscustomobject]@{
|
||||||
Version = $Version
|
Version = $Version
|
||||||
ClientPackage = $clientZip
|
WindowsClientPackage = $clientZip
|
||||||
ClientSha256 = (Get-FileHash -LiteralPath $clientZip -Algorithm SHA256).Hash
|
WindowsClientSha256 = (Get-FileHash -LiteralPath $clientZip -Algorithm SHA256).Hash
|
||||||
|
LinuxClientPackage = $linuxClientZip
|
||||||
|
LinuxClientSha256 = (Get-FileHash -LiteralPath $linuxClientZip -Algorithm SHA256).Hash
|
||||||
ServerPackage = $serverZip
|
ServerPackage = $serverZip
|
||||||
ServerSha256 = (Get-FileHash -LiteralPath $serverZip -Algorithm SHA256).Hash
|
ServerSha256 = (Get-FileHash -LiteralPath $serverZip -Algorithm SHA256).Hash
|
||||||
|
AzureInfrastructurePackage = $azureZip
|
||||||
|
AzureInfrastructureSha256 = (Get-FileHash -LiteralPath $azureZip -Algorithm SHA256).Hash
|
||||||
|
CedWifiPolicyPackage = $wifiZip
|
||||||
|
CedWifiPolicySha256 = (Get-FileHash -LiteralPath $wifiZip -Algorithm SHA256).Hash
|
||||||
Checksums = $checksumsPath
|
Checksums = $checksumsPath
|
||||||
RuntimeInstaller = $runtimeInstaller.Name
|
RuntimeInstaller = $runtimeInstaller.Name
|
||||||
}
|
}
|
||||||
@@ -9,14 +9,21 @@ param(
|
|||||||
[string]$Owner = 'alexrg',
|
[string]$Owner = 'alexrg',
|
||||||
[string]$Repository = 'SGU-CredentialProvider',
|
[string]$Repository = 'SGU-CredentialProvider',
|
||||||
[string]$TargetCommitish = 'main',
|
[string]$TargetCommitish = 'main',
|
||||||
|
[string]$ReleaseNotesPath,
|
||||||
[switch]$Draft
|
[switch]$Draft
|
||||||
)
|
)
|
||||||
|
|
||||||
$ErrorActionPreference = 'Stop'
|
$ErrorActionPreference = 'Stop'
|
||||||
|
if ($ReleaseNotesPath -and -not (Test-Path -LiteralPath $ReleaseNotesPath -PathType Leaf)) {
|
||||||
|
throw "Release notes file is missing: $ReleaseNotesPath"
|
||||||
|
}
|
||||||
$tagName = "v$Version"
|
$tagName = "v$Version"
|
||||||
$assetPaths = @(
|
$assetPaths = @(
|
||||||
(Join-Path $ReleaseDirectory "sgu-client-bootstrap-$Version.zip"),
|
(Join-Path $ReleaseDirectory "sgu-windows-client-bootstrap-$Version.zip"),
|
||||||
(Join-Path $ReleaseDirectory "sgu-server-bootstrap-$Version.zip"),
|
(Join-Path $ReleaseDirectory "sgu-server-bootstrap-$Version.zip"),
|
||||||
|
(Join-Path $ReleaseDirectory "sgu-linux-client-bootstrap-$Version.zip"),
|
||||||
|
(Join-Path $ReleaseDirectory "sgu-azure-infrastructure-$Version.zip"),
|
||||||
|
(Join-Path $ReleaseDirectory "sgu-ced-wifi-policy-$Version.zip"),
|
||||||
(Join-Path $ReleaseDirectory "SHA256SUMS-$Version.txt")
|
(Join-Path $ReleaseDirectory "SHA256SUMS-$Version.txt")
|
||||||
)
|
)
|
||||||
foreach ($assetPath in $assetPaths) {
|
foreach ($assetPath in $assetPaths) {
|
||||||
@@ -26,7 +33,9 @@ foreach ($assetPath in $assetPaths) {
|
|||||||
}
|
}
|
||||||
|
|
||||||
$token = $env:GITEA_TOKEN
|
$token = $env:GITEA_TOKEN
|
||||||
if (-not $token) {
|
$authorizationScheme = 'token'
|
||||||
|
$authorizationParameter = $token
|
||||||
|
if (-not $authorizationParameter) {
|
||||||
$credentialInput = "protocol=$($GiteaBaseUri.Scheme)`nhost=$($GiteaBaseUri.Host)`n`n"
|
$credentialInput = "protocol=$($GiteaBaseUri.Scheme)`nhost=$($GiteaBaseUri.Host)`n`n"
|
||||||
$credentialOutput = $credentialInput | & git credential fill
|
$credentialOutput = $credentialInput | & git credential fill
|
||||||
if ($LASTEXITCODE -ne 0) {
|
if ($LASTEXITCODE -ne 0) {
|
||||||
@@ -39,17 +48,26 @@ if (-not $token) {
|
|||||||
$credentialValues[$parts[0]] = $parts[1]
|
$credentialValues[$parts[0]] = $parts[1]
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
$token = $credentialValues.password
|
if ($credentialValues.username -and $credentialValues.password) {
|
||||||
|
$authorizationScheme = 'Basic'
|
||||||
|
$basicCredential = '{0}:{1}' -f $credentialValues.username,$credentialValues.password
|
||||||
|
$authorizationParameter = [Convert]::ToBase64String(
|
||||||
|
[Text.Encoding]::UTF8.GetBytes($basicCredential))
|
||||||
|
$basicCredential = $null
|
||||||
|
}
|
||||||
}
|
}
|
||||||
if (-not $token) {
|
if (-not $authorizationParameter) {
|
||||||
throw 'No Gitea token is available. Set GITEA_TOKEN for this process or sign in through Git Credential Manager.'
|
throw 'No Gitea credential is available. Set GITEA_TOKEN for this process or sign in through Git Credential Manager.'
|
||||||
}
|
}
|
||||||
|
|
||||||
Add-Type -AssemblyName System.Net.Http
|
Add-Type -AssemblyName System.Net.Http
|
||||||
$handler = [Net.Http.HttpClientHandler]::new()
|
$handler = [Net.Http.HttpClientHandler]::new()
|
||||||
$client = [Net.Http.HttpClient]::new($handler)
|
$client = [Net.Http.HttpClient]::new($handler)
|
||||||
|
$client.Timeout = [TimeSpan]::FromMinutes(10)
|
||||||
$client.BaseAddress = [uri]($GiteaBaseUri.AbsoluteUri.TrimEnd('/') + '/')
|
$client.BaseAddress = [uri]($GiteaBaseUri.AbsoluteUri.TrimEnd('/') + '/')
|
||||||
$client.DefaultRequestHeaders.Authorization = [Net.Http.Headers.AuthenticationHeaderValue]::new('token', $token)
|
$client.DefaultRequestHeaders.Authorization = [Net.Http.Headers.AuthenticationHeaderValue]::new(
|
||||||
|
$authorizationScheme,
|
||||||
|
$authorizationParameter)
|
||||||
$client.DefaultRequestHeaders.UserAgent.ParseAdd('SGU-CredentialProvider-Release/1.0')
|
$client.DefaultRequestHeaders.UserAgent.ParseAdd('SGU-CredentialProvider-Release/1.0')
|
||||||
|
|
||||||
function Invoke-GiteaJson {
|
function Invoke-GiteaJson {
|
||||||
@@ -99,17 +117,35 @@ Bootstrap reproducible para el laboratorio SGU.
|
|||||||
|
|
||||||
- **Advertencia:** el bootstrap de servidor crea un bosque nuevo. No restaura los SID, contraseñas ni relaciones de confianza del bosque anterior; para conservarlos se requiere una recuperación de bosque desde una copia de estado del sistema.
|
- **Advertencia:** el bootstrap de servidor crea un bosque nuevo. No restaura los SID, contraseñas ni relaciones de confianza del bosque anterior; para conservarlos se requiere una recuperación de bosque desde una copia de estado del sistema.
|
||||||
- `sgu-server-bootstrap-$Version.zip`: crea el bosque AD/DNS, OUs, grupo RDP, GPO, recurso `Packages`, broker mTLS y administración remota; se reanuda solo después del reinicio.
|
- `sgu-server-bootstrap-$Version.zip`: crea el bosque AD/DNS, OUs, grupo RDP, GPO, recurso `Packages`, broker mTLS y administración remota; se reanuda solo después del reinicio.
|
||||||
- `sgu-client-bootstrap-$Version.zip`: registra un certificado mTLS único, instala y valida el Credential Provider antes de unir el equipo al dominio, habilita RDP/WinRM y se repara al arranque.
|
- `sgu-windows-client-bootstrap-$Version.zip`: paquete único para Windows 10 1607+ y Windows 11 x64 Pro, Enterprise o Education, con LAN, VPN existente y Azure P2S opcional.
|
||||||
|
- Doble clic en `Start-SguClientEnrollment.cmd`, IP del servidor y credenciales: descubre el dominio autenticado, comprueba las interfaces y rutas disponibles y conserva DHCP, las IP del cliente y el DNS de Internet. Ya no solicita una IP del cliente.
|
||||||
|
- Si la IP del DC es pública, configura automáticamente DoH autenticado, confianza del certificado, NRPT y nombres del bosque antes de unir el equipo; funciona con cualquier interfaz que pueda alcanzar el servidor.
|
||||||
|
- Conserva seguridad mTLS, Credential Provider, cuenta estándar, RustDesk, supervisión y autorreparación. El servidor puede ser accesible por LAN, una VPN ya conectada o un CIDR público autorizado.
|
||||||
|
- `sgu-linux-client-bootstrap-$Version.zip`: une clientes Debian/Ubuntu o RHEL/Fedora/Rocky/AlmaLinux con realmd, Kerberos y SSSD. Solicita interactivamente la contraseña de unión y no instala el Credential Provider de Windows.
|
||||||
|
- `sgu-azure-infrastructure-$Version.zip`: despliega mediante Bicep una VM Windows Server 2025, red privada e IP pública protegida por NSG; Azure VPN Gateway P2S es opcional.
|
||||||
|
- El modo directo recibe una lista explícita de CIDR públicos, la replica en NSG y Windows Firewall y deja cerrados los puertos de enrolamiento cuando la lista está vacía.
|
||||||
|
- Windows 10 y 11 pueden instalar el perfil IKEv2 de todos los usuarios con certificado de máquina y DNS dividido del dominio; la disponibilidad antes del inicio de sesión depende del perfil y de las políticas del equipo.
|
||||||
|
- El Auth Broker clasifica sin tareas programadas cada cuenta autenticada: `AL` se agrega a `SGU-Alumnos`, `AD` a `SGU-Administrativos` y `DO` a `SGU-Docentes`; el bootstrap crea cada grupo dentro de la OU de su rol y migra idempotentemente cualquier grupo heredado sin cambiar su SID.
|
||||||
|
- El Auth Broker resuelve la dirección guardada de administrativos y docentes mediante `GetDireccion`, `GetLocalidadListado` y `GetColoniasListado`, evitando conservar los valores transitorios `Seleccione...` de los controles dinámicos de SGU.
|
||||||
|
- El enrolamiento y la reparación de clientes Windows crean y verifican idempotentemente la cuenta local estándar `alumno`, sin pertenencia al grupo de administradores.
|
||||||
|
- La descripción de la cuenta local administrada respeta el límite de 48 caracteres de Windows 10 Enterprise.
|
||||||
|
- La validación de expiración de contraseña usa el indicador de cuenta compatible con Windows 10 y 11, en lugar de una propiedad que Windows 10 no expone.
|
||||||
|
- El enriquecimiento obtiene el sexo de los módulos SGU de personal/alumnos, lo conserva como la línea administrada `SGU-Gender: Male|Female` en Notas de AD y adapta el fondo de Windows/Linux; cuando falta utiliza redacción neutral.
|
||||||
|
- El servidor configura WEF/WEC para registrar sesiones y fallos, inventariar el estado alcanzable de las máquinas cada cinco minutos y conservar durante 183 días tanto esos eventos como el diagnóstico estructurado del Auth Broker.
|
||||||
- Windows Home se detecta y se rechaza con una explicación, ya que no admite unión a Active Directory ni RDP host.
|
- Windows Home se detecta y se rechaza con una explicación, ya que no admite unión a Active Directory ni RDP host.
|
||||||
|
|
||||||
Las contraseñas se solicitan de forma interactiva y no se escriben en archivos ni en la línea de comandos. Verifique los ZIP con `SHA256SUMS-$Version.txt`.
|
Las contraseñas se solicitan de forma interactiva y no se escriben en archivos ni en la línea de comandos. Verifique los ZIP con `SHA256SUMS-$Version.txt`.
|
||||||
"@
|
"@
|
||||||
|
if ($ReleaseNotesPath) {
|
||||||
|
$releaseNotes = Get-Content -LiteralPath $ReleaseNotesPath -Raw -Encoding UTF8
|
||||||
|
}
|
||||||
$releaseBody = [ordered]@{
|
$releaseBody = [ordered]@{
|
||||||
tag_name = $tagName
|
tag_name = $tagName
|
||||||
target_commitish = $TargetCommitish
|
target_commitish = $TargetCommitish
|
||||||
name = "SGU Credential Provider $Version"
|
name = "SGU Credential Provider $Version"
|
||||||
body = $releaseNotes
|
body = $releaseNotes
|
||||||
draft = [bool]$Draft
|
# Keep the release private until every attachment has uploaded.
|
||||||
|
draft = $true
|
||||||
prerelease = $Version -match '-'
|
prerelease = $Version -match '-'
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -141,6 +177,11 @@ Las contraseñas se solicitan de forma interactiva y no se escriben en archivos
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
if (-not $Draft) {
|
||||||
|
$release = Invoke-GiteaJson -Method ([Net.Http.HttpMethod]::Patch) `
|
||||||
|
-RelativeUri "$repositoryPath/releases/$($release.id)" -Body @{draft=$false}
|
||||||
|
}
|
||||||
|
|
||||||
[pscustomobject]@{
|
[pscustomobject]@{
|
||||||
Tag = $tagName
|
Tag = $tagName
|
||||||
ReleaseName = $release.name
|
ReleaseName = $release.name
|
||||||
@@ -151,6 +192,8 @@ Las contraseñas se solicitan de forma interactiva y no se escriben en archivos
|
|||||||
}
|
}
|
||||||
finally {
|
finally {
|
||||||
$token = $null
|
$token = $null
|
||||||
|
$authorizationParameter = $null
|
||||||
|
$credentialValues = $null
|
||||||
$client.Dispose()
|
$client.Dispose()
|
||||||
$handler.Dispose()
|
$handler.Dispose()
|
||||||
}
|
}
|
||||||
@@ -0,0 +1,140 @@
|
|||||||
|
#Requires -Version 5.1
|
||||||
|
[CmdletBinding(SupportsShouldProcess)]
|
||||||
|
param(
|
||||||
|
[string]$GpoName = 'SGU - FSLogix client deployment',
|
||||||
|
[string]$LaboratoryOuDn,
|
||||||
|
[uri]$InstallerZipUri = 'https://download.microsoft.com/download/ae6d2014-e692-45fa-a88b-ee552567cdc1/FSLogix_26.08.zip',
|
||||||
|
[string]$ExpectedInstallerSha256 = '0BAF7FE8195571060F0361B351E58FE6CD422AE521A96BAB3E66D900544E8A30',
|
||||||
|
[string]$CacheRoot = "$env:ProgramData\SGU\FSLogixDeployment\26.08"
|
||||||
|
)
|
||||||
|
|
||||||
|
$ErrorActionPreference = 'Stop'
|
||||||
|
$identity = [Security.Principal.WindowsIdentity]::GetCurrent()
|
||||||
|
$principal = [Security.Principal.WindowsPrincipal]::new($identity)
|
||||||
|
if (-not $principal.IsInRole([Security.Principal.WindowsBuiltInRole]::Administrator)) {
|
||||||
|
throw 'Run the FSLogix GPO deployment from an elevated Windows PowerShell session.'
|
||||||
|
}
|
||||||
|
Import-Module ActiveDirectory -ErrorAction Stop
|
||||||
|
Import-Module GroupPolicy -ErrorAction Stop
|
||||||
|
|
||||||
|
$domain = Get-ADDomain
|
||||||
|
$domainName = $domain.DNSRoot
|
||||||
|
$domainDn = $domain.DistinguishedName
|
||||||
|
if (-not $LaboratoryOuDn) { $LaboratoryOuDn = "OU=Laboratorio,$domainDn" }
|
||||||
|
Get-ADOrganizationalUnit -Identity $LaboratoryOuDn -ErrorAction Stop | Out-Null
|
||||||
|
|
||||||
|
$zipPath = Join-Path $CacheRoot 'FSLogix_26.08.zip'
|
||||||
|
$extractRoot = Join-Path $CacheRoot 'expanded'
|
||||||
|
$installerPath = Join-Path $extractRoot 'x64\Release\FSLogixAppsSetup.exe'
|
||||||
|
if (-not (Test-Path -LiteralPath $installerPath -PathType Leaf)) {
|
||||||
|
if (-not $PSCmdlet.ShouldProcess($InstallerZipUri.AbsoluteUri, "Download official FSLogix package to $zipPath")) { return }
|
||||||
|
New-Item -ItemType Directory -Path $CacheRoot,$extractRoot -Force | Out-Null
|
||||||
|
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
|
||||||
|
Invoke-WebRequest -Uri $InstallerZipUri -OutFile $zipPath -UseBasicParsing
|
||||||
|
Expand-Archive -LiteralPath $zipPath -DestinationPath $extractRoot -Force
|
||||||
|
}
|
||||||
|
if (-not (Test-Path -LiteralPath $installerPath -PathType Leaf)) {
|
||||||
|
throw "The FSLogix x64 installer is missing after extraction: $installerPath"
|
||||||
|
}
|
||||||
|
$signature = Get-AuthenticodeSignature -LiteralPath $installerPath
|
||||||
|
if ($signature.Status -ne [Management.Automation.SignatureStatus]::Valid -or
|
||||||
|
-not $signature.SignerCertificate -or
|
||||||
|
$signature.SignerCertificate.Subject -notmatch '(^|,\s*)CN=Microsoft Corporation(,|$)') {
|
||||||
|
throw 'FSLogixAppsSetup.exe does not have a valid Microsoft Corporation signature.'
|
||||||
|
}
|
||||||
|
$installerHash = (Get-FileHash -LiteralPath $installerPath -Algorithm SHA256).Hash
|
||||||
|
if ($installerHash -ne $ExpectedInstallerSha256) {
|
||||||
|
throw "FSLogixAppsSetup.exe SHA-256 mismatch. Expected $ExpectedInstallerSha256; received $installerHash."
|
||||||
|
}
|
||||||
|
|
||||||
|
$gpo = Get-GPO -Name $GpoName -Domain $domainName -ErrorAction SilentlyContinue
|
||||||
|
if (-not $gpo) { $gpo = New-GPO -Name $GpoName -Domain $domainName }
|
||||||
|
$links = @(Get-GPInheritance -Target $LaboratoryOuDn -Domain $domainName).GpoLinks
|
||||||
|
if (-not ($links | Where-Object DisplayName -eq $GpoName)) {
|
||||||
|
New-GPLink -Name $GpoName -Target $LaboratoryOuDn -Domain $domainName -LinkEnabled Yes | Out-Null
|
||||||
|
}
|
||||||
|
|
||||||
|
# Set one ordinary machine value through the supported cmdlet. Besides providing
|
||||||
|
# a deployment marker, this initializes the computer half of the GPO and its
|
||||||
|
# Registry client-side extension before the Scripts extension is added below.
|
||||||
|
Set-GPRegistryValue -Name $GpoName -Domain $domainName `
|
||||||
|
-Key 'HKLM\SOFTWARE\SGU\FSLogixDeployment' -ValueName 'Version' `
|
||||||
|
-Type String -Value '26.08-3.26.826.17182' | Out-Null
|
||||||
|
$gpo = Get-GPO -Name $GpoName -Domain $domainName
|
||||||
|
$guid = $gpo.Id.ToString('B').ToUpperInvariant()
|
||||||
|
$gpoRoot = "\\$domainName\SYSVOL\$domainName\Policies\$guid"
|
||||||
|
$scriptsRoot = Join-Path $gpoRoot 'Machine\Scripts'
|
||||||
|
$startupRoot = Join-Path $scriptsRoot 'Startup'
|
||||||
|
New-Item -ItemType Directory -Path $startupRoot -Force | Out-Null
|
||||||
|
Copy-Item -LiteralPath $installerPath -Destination (Join-Path $startupRoot 'FSLogixAppsSetup.exe') -Force
|
||||||
|
|
||||||
|
$startupPowerShell = @'
|
||||||
|
$ErrorActionPreference = 'Stop'
|
||||||
|
$appsRoot = Join-Path $env:ProgramFiles 'FSLogix\Apps'
|
||||||
|
$frx = Join-Path $appsRoot 'frx.exe'
|
||||||
|
if ((Get-Service frxsvc -ErrorAction SilentlyContinue) -and (Test-Path -LiteralPath $frx)) { exit 0 }
|
||||||
|
$source = Join-Path $PSScriptRoot 'FSLogixAppsSetup.exe'
|
||||||
|
$signature = Get-AuthenticodeSignature -LiteralPath $source
|
||||||
|
if ($signature.Status -ne 'Valid' -or -not $signature.SignerCertificate -or
|
||||||
|
$signature.SignerCertificate.Subject -notmatch '(^|,\s*)CN=Microsoft Corporation(,|$)') { exit 10 }
|
||||||
|
$targetRoot = Join-Path $env:ProgramData 'SGU\FSLogix'
|
||||||
|
New-Item -ItemType Directory -Path $targetRoot -Force | Out-Null
|
||||||
|
$target = Join-Path $targetRoot 'FSLogixAppsSetup.exe'
|
||||||
|
Copy-Item -LiteralPath $source -Destination $target -Force
|
||||||
|
$log = Join-Path $targetRoot 'install.log'
|
||||||
|
$process = Start-Process -FilePath $target -ArgumentList @('/install','/quiet','/norestart','/log',"`"$log`"") -Wait -PassThru
|
||||||
|
if ($process.ExitCode -notin @(0,1641,3010)) { exit $process.ExitCode }
|
||||||
|
if (-not (Get-Service frxsvc -ErrorAction SilentlyContinue) -or -not (Test-Path -LiteralPath $frx)) { exit 11 }
|
||||||
|
exit 0
|
||||||
|
'@
|
||||||
|
[IO.File]::WriteAllText(
|
||||||
|
(Join-Path $startupRoot 'Install-SguFsLogix-Startup.ps1'),
|
||||||
|
$startupPowerShell,
|
||||||
|
[Text.UTF8Encoding]::new($true))
|
||||||
|
$startupCommand = '@echo off' + [Environment]::NewLine +
|
||||||
|
'powershell.exe -NoProfile -NonInteractive -ExecutionPolicy Bypass -File "%~dp0Install-SguFsLogix-Startup.ps1"' + [Environment]::NewLine +
|
||||||
|
'exit /b %ERRORLEVEL%' + [Environment]::NewLine
|
||||||
|
[IO.File]::WriteAllText(
|
||||||
|
(Join-Path $startupRoot 'Install-SguFsLogix.cmd'),
|
||||||
|
$startupCommand,
|
||||||
|
[Text.Encoding]::ASCII)
|
||||||
|
$scriptsIni = "[Startup]`r`n0CmdLine=Install-SguFsLogix.cmd`r`n0Parameters=`r`n"
|
||||||
|
[IO.File]::WriteAllText(
|
||||||
|
(Join-Path $scriptsRoot 'scripts.ini'),
|
||||||
|
$scriptsIni,
|
||||||
|
[Text.Encoding]::Unicode)
|
||||||
|
|
||||||
|
$policyDn = "CN=$guid,CN=Policies,CN=System,$domainDn"
|
||||||
|
$policy = Get-ADObject -Identity $policyDn -Properties versionNumber,gPCMachineExtensionNames
|
||||||
|
$scriptExtension = '[{42B5FAAE-6536-11D2-AE5A-0000F87571E3}{40B6664F-4972-11D1-A7CA-0000F87571E3}]'
|
||||||
|
$extensions = @([regex]::Matches([string]$policy.gPCMachineExtensionNames, '\[\{[0-9A-Fa-f-]{36}\}\{[0-9A-Fa-f-]{36}\}\]') |
|
||||||
|
ForEach-Object Value)
|
||||||
|
if ($extensions -notcontains $scriptExtension) { $extensions += $scriptExtension }
|
||||||
|
$extensionValue = ($extensions | Sort-Object { $_.Substring(1, 38) }) -join ''
|
||||||
|
$currentVersion = [int64]$policy.versionNumber
|
||||||
|
$machineVersion = $currentVersion -band 0xFFFF
|
||||||
|
if ($machineVersion -ge 65535) { throw 'The computer GPO version cannot be incremented further.' }
|
||||||
|
$newVersion = ($currentVersion -band 0xFFFF0000) -bor ($machineVersion + 1)
|
||||||
|
$gptIniPath = Join-Path $gpoRoot 'gpt.ini'
|
||||||
|
$gptLines = @(Get-Content -LiteralPath $gptIniPath)
|
||||||
|
$versionFound = $false
|
||||||
|
$gptLines = @($gptLines | ForEach-Object {
|
||||||
|
if ($_ -match '^Version=') { $versionFound = $true; "Version=$newVersion" } else { $_ }
|
||||||
|
})
|
||||||
|
if (-not $versionFound) { $gptLines += "Version=$newVersion" }
|
||||||
|
[IO.File]::WriteAllLines($gptIniPath, $gptLines, [Text.Encoding]::ASCII)
|
||||||
|
Set-ADObject -Identity $policy -Replace @{
|
||||||
|
gPCMachineExtensionNames = $extensionValue
|
||||||
|
versionNumber = [int]$newVersion
|
||||||
|
}
|
||||||
|
|
||||||
|
$verifiedGpo = Get-GPO -Name $GpoName -Domain $domainName
|
||||||
|
[pscustomobject]@{
|
||||||
|
GpoName = $verifiedGpo.DisplayName
|
||||||
|
GpoId = $verifiedGpo.Id
|
||||||
|
LaboratoryOuDn = $LaboratoryOuDn
|
||||||
|
MachineVersion = $verifiedGpo.Computer.DSVersion
|
||||||
|
InstallerVersion = '3.26.826.17182'
|
||||||
|
InstallerSha256 = $installerHash
|
||||||
|
StartupScript = Join-Path $startupRoot 'Install-SguFsLogix.cmd'
|
||||||
|
}
|
||||||
@@ -0,0 +1,97 @@
|
|||||||
|
[CmdletBinding(SupportsShouldProcess)]
|
||||||
|
param(
|
||||||
|
[Parameter(Mandatory)]
|
||||||
|
[ValidatePattern('^[A-Za-z0-9][A-Za-z0-9-]{0,62}$')]
|
||||||
|
[string]$ComputerName,
|
||||||
|
|
||||||
|
[Parameter(Mandatory)]
|
||||||
|
[ValidatePattern('^\d+$')]
|
||||||
|
[string]$RustDeskId,
|
||||||
|
|
||||||
|
[Parameter(Mandatory)]
|
||||||
|
[ValidateLength(12, 256)]
|
||||||
|
[string]$AccessPassword,
|
||||||
|
|
||||||
|
[string]$InventoryRoot = "$env:ProgramData\SGU\RustDesk\Devices"
|
||||||
|
)
|
||||||
|
|
||||||
|
$ErrorActionPreference = 'Stop'
|
||||||
|
|
||||||
|
function Assert-Administrator {
|
||||||
|
$identity = [Security.Principal.WindowsIdentity]::GetCurrent()
|
||||||
|
$principal = [Security.Principal.WindowsPrincipal]::new($identity)
|
||||||
|
if (-not $principal.IsInRole([Security.Principal.WindowsBuiltInRole]::Administrator)) {
|
||||||
|
throw 'Only a local administrator can register a RustDesk device credential.'
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
function Initialize-DataProtection {
|
||||||
|
if (-not ('SguRustDeskDataProtection' -as [type])) {
|
||||||
|
Add-Type -TypeDefinition @'
|
||||||
|
using System;
|
||||||
|
using System.ComponentModel;
|
||||||
|
using System.Runtime.InteropServices;
|
||||||
|
public static class SguRustDeskDataProtection {
|
||||||
|
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
|
||||||
|
private struct DataBlob { public int cbData; public IntPtr pbData; }
|
||||||
|
[DllImport("crypt32.dll", SetLastError = true, CharSet = CharSet.Unicode)]
|
||||||
|
private static extern bool CryptProtectData(ref DataBlob input, string description, IntPtr entropy, IntPtr reserved, IntPtr prompt, int flags, out DataBlob output);
|
||||||
|
[DllImport("crypt32.dll", SetLastError = true, CharSet = CharSet.Unicode)]
|
||||||
|
private static extern bool CryptUnprotectData(ref DataBlob input, IntPtr description, IntPtr entropy, IntPtr reserved, IntPtr prompt, int flags, out DataBlob output);
|
||||||
|
[DllImport("kernel32.dll", SetLastError = true)] private static extern IntPtr LocalFree(IntPtr memory);
|
||||||
|
private const int CryptProtectLocalMachine = 0x4;
|
||||||
|
private static DataBlob ToBlob(byte[] value) { var blob = new DataBlob { cbData = value.Length, pbData = IntPtr.Zero }; if (value.Length > 0) { blob.pbData = Marshal.AllocHGlobal(value.Length); Marshal.Copy(value, 0, blob.pbData, value.Length); } return blob; }
|
||||||
|
private static byte[] FromBlob(DataBlob blob) { var value = new byte[blob.cbData]; if (blob.cbData > 0) Marshal.Copy(blob.pbData, value, 0, blob.cbData); return value; }
|
||||||
|
public static byte[] Protect(byte[] value) { var input = ToBlob(value); var output = new DataBlob(); try { if (!CryptProtectData(ref input, null, IntPtr.Zero, IntPtr.Zero, IntPtr.Zero, CryptProtectLocalMachine, out output)) throw new Win32Exception(Marshal.GetLastWin32Error()); return FromBlob(output); } finally { if (input.pbData != IntPtr.Zero) Marshal.FreeHGlobal(input.pbData); if (output.pbData != IntPtr.Zero) LocalFree(output.pbData); } }
|
||||||
|
public static byte[] Unprotect(byte[] value) { var input = ToBlob(value); var output = new DataBlob(); try { if (!CryptUnprotectData(ref input, IntPtr.Zero, IntPtr.Zero, IntPtr.Zero, IntPtr.Zero, 0, out output)) throw new Win32Exception(Marshal.GetLastWin32Error()); return FromBlob(output); } finally { if (input.pbData != IntPtr.Zero) Marshal.FreeHGlobal(input.pbData); if (output.pbData != IntPtr.Zero) LocalFree(output.pbData); } }
|
||||||
|
}
|
||||||
|
'@ -ErrorAction Stop
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
function Set-PrivateDirectoryAcl {
|
||||||
|
param([Parameter(Mandatory)][string]$Path)
|
||||||
|
|
||||||
|
New-Item -ItemType Directory -Path $Path -Force | Out-Null
|
||||||
|
$acl = New-Object Security.AccessControl.DirectorySecurity
|
||||||
|
$acl.SetAccessRuleProtection($true, $false)
|
||||||
|
$inheritance = [Security.AccessControl.InheritanceFlags]'ContainerInherit,ObjectInherit'
|
||||||
|
$allow = [Security.AccessControl.AccessControlType]::Allow
|
||||||
|
foreach ($sid in @('S-1-5-18', 'S-1-5-32-544')) {
|
||||||
|
$acl.AddAccessRule([Security.AccessControl.FileSystemAccessRule]::new(
|
||||||
|
[Security.Principal.SecurityIdentifier]::new($sid),
|
||||||
|
[Security.AccessControl.FileSystemRights]::FullControl,
|
||||||
|
$inheritance,
|
||||||
|
[Security.AccessControl.PropagationFlags]::None,
|
||||||
|
$allow))
|
||||||
|
}
|
||||||
|
Set-Acl -LiteralPath $Path -AclObject $acl
|
||||||
|
}
|
||||||
|
|
||||||
|
Assert-Administrator
|
||||||
|
Initialize-DataProtection
|
||||||
|
if (-not $PSCmdlet.ShouldProcess($ComputerName, 'Register the protected RustDesk management credential')) {
|
||||||
|
return
|
||||||
|
}
|
||||||
|
|
||||||
|
Set-PrivateDirectoryAcl -Path $InventoryRoot
|
||||||
|
$normalizedName = $ComputerName.ToUpperInvariant()
|
||||||
|
$secretPath = Join-Path $InventoryRoot "$normalizedName.secret"
|
||||||
|
$metadataPath = Join-Path $InventoryRoot "$normalizedName.json"
|
||||||
|
$protectedPassword = [SguRustDeskDataProtection]::Protect(
|
||||||
|
[Text.Encoding]::UTF8.GetBytes($AccessPassword))
|
||||||
|
[IO.File]::WriteAllBytes($secretPath, $protectedPassword)
|
||||||
|
$metadata = [ordered]@{
|
||||||
|
ComputerName = $normalizedName
|
||||||
|
RustDeskId = $RustDeskId
|
||||||
|
RegisteredAt = (Get-Date).ToString('o')
|
||||||
|
SecretPath = $secretPath
|
||||||
|
}
|
||||||
|
[IO.File]::WriteAllText($metadataPath, ($metadata | ConvertTo-Json), [Text.UTF8Encoding]::new($false))
|
||||||
|
|
||||||
|
[pscustomobject]@{
|
||||||
|
ComputerName = $normalizedName
|
||||||
|
RustDeskId = $RustDeskId
|
||||||
|
Registered = $true
|
||||||
|
MetadataPath = $metadataPath
|
||||||
|
}
|
||||||
@@ -0,0 +1,99 @@
|
|||||||
|
#Requires -Version 5.1
|
||||||
|
#Requires -RunAsAdministrator
|
||||||
|
[CmdletBinding()]
|
||||||
|
param(
|
||||||
|
[string]$ConnectionName = 'SGU Azure Device',
|
||||||
|
[ValidateRange(30,600)][int]$WaitSeconds = 180
|
||||||
|
)
|
||||||
|
|
||||||
|
$ErrorActionPreference = 'Stop'
|
||||||
|
$computer = Get-CimInstance Win32_ComputerSystem
|
||||||
|
if (-not $computer.PartOfDomain) { throw 'The device must already be joined to its domain.' }
|
||||||
|
$logPath = Join-Path $env:ProgramData 'SGU\Enrollment\azure-domain-connectivity.json'
|
||||||
|
$deadline = (Get-Date).AddSeconds($WaitSeconds)
|
||||||
|
$restarted = $false
|
||||||
|
$controller = $null
|
||||||
|
try {
|
||||||
|
do {
|
||||||
|
$vpn = Get-VpnConnection -Name $ConnectionName -AllUserConnection -ErrorAction SilentlyContinue
|
||||||
|
$reachable = $false
|
||||||
|
if ($vpn -and $vpn.ConnectionStatus -eq 'Connected') {
|
||||||
|
$record = Resolve-DnsName "_ldap._tcp.dc._msdcs.$($computer.Domain)" -Type SRV -ErrorAction SilentlyContinue |
|
||||||
|
Where-Object Type -eq 'SRV' | Select-Object -First 1
|
||||||
|
if ($record) {
|
||||||
|
$controller = $record.NameTarget.TrimEnd('.')
|
||||||
|
$socket = [Net.Sockets.TcpClient]::new()
|
||||||
|
try {
|
||||||
|
$connect = $socket.BeginConnect($controller, 389, $null, $null)
|
||||||
|
if ($connect.AsyncWaitHandle.WaitOne(2000)) {
|
||||||
|
$socket.EndConnect($connect)
|
||||||
|
$reachable = $socket.Connected
|
||||||
|
}
|
||||||
|
} catch { $reachable = $false }
|
||||||
|
finally { $socket.Dispose() }
|
||||||
|
}
|
||||||
|
}
|
||||||
|
if ($reachable) { break }
|
||||||
|
Start-Sleep -Seconds 5
|
||||||
|
} while ((Get-Date) -lt $deadline)
|
||||||
|
if (-not $reachable) { throw "The VPN and a domain controller were not reachable within $WaitSeconds seconds." }
|
||||||
|
|
||||||
|
# An early Netlogon attempt can remain failed after the device VPN connects.
|
||||||
|
# Refresh only that service, after confirming the domain is reachable.
|
||||||
|
if (-not (Test-ComputerSecureChannel -Server $controller)) {
|
||||||
|
Restart-Service -Name Netlogon
|
||||||
|
$restarted = $true
|
||||||
|
}
|
||||||
|
$secure = $false
|
||||||
|
for ($attempt = 0; $attempt -lt 6; $attempt++) {
|
||||||
|
$secure = Test-ComputerSecureChannel -Server $controller
|
||||||
|
if ($secure) { break }
|
||||||
|
Start-Sleep -Seconds 5
|
||||||
|
}
|
||||||
|
if (-not $secure) { throw 'The domain is reachable but the secure channel is still invalid. Administrative repair is required.' }
|
||||||
|
$guard = Get-ScheduledTask -TaskName 'SGU-CredentialProvider-EnrollmentGuard' -ErrorAction SilentlyContinue
|
||||||
|
$guardResult = $null
|
||||||
|
if ($guard) {
|
||||||
|
# Domain principal lookup can recover after the secure channel itself.
|
||||||
|
# Await the guard and retry a transient failure instead of reporting
|
||||||
|
# success while its asynchronous repair is still running or failed.
|
||||||
|
$guardDeadline = (Get-Date).AddMinutes(3)
|
||||||
|
do {
|
||||||
|
$guard = Get-ScheduledTask -TaskName $guard.TaskName
|
||||||
|
if ($guard.State -notin @('Running','Queued')) {
|
||||||
|
$previousRun = (Get-ScheduledTaskInfo -TaskName $guard.TaskName).LastRunTime
|
||||||
|
Start-ScheduledTask -InputObject $guard
|
||||||
|
do {
|
||||||
|
Start-Sleep -Seconds 2
|
||||||
|
$guard = Get-ScheduledTask -TaskName $guard.TaskName
|
||||||
|
$info = Get-ScheduledTaskInfo -TaskName $guard.TaskName
|
||||||
|
} while (($info.LastRunTime -le $previousRun -or $guard.State -in @('Running','Queued')) -and (Get-Date) -lt $guardDeadline)
|
||||||
|
if ($info.LastRunTime -gt $previousRun -and $guard.State -notin @('Running','Queued')) {
|
||||||
|
$guardResult = $info.LastTaskResult
|
||||||
|
if ($guardResult -eq 0) { break }
|
||||||
|
}
|
||||||
|
}
|
||||||
|
Start-Sleep -Seconds 10
|
||||||
|
} while ((Get-Date) -lt $guardDeadline)
|
||||||
|
if ($guardResult -ne 0) { throw "The secure channel recovered, but the enrollment guard did not succeed (result $guardResult)." }
|
||||||
|
}
|
||||||
|
[pscustomobject]@{
|
||||||
|
CheckedAt = (Get-Date).ToString('o')
|
||||||
|
ComputerName = $computer.Name
|
||||||
|
Domain = $computer.Domain
|
||||||
|
DomainController = $controller
|
||||||
|
ConnectionName = $ConnectionName
|
||||||
|
NetlogonRestarted = $restarted
|
||||||
|
SecureChannel = $secure
|
||||||
|
EnrollmentGuardResult = $guardResult
|
||||||
|
} | ConvertTo-Json | Set-Content -LiteralPath $logPath
|
||||||
|
} catch {
|
||||||
|
[pscustomobject]@{
|
||||||
|
CheckedAt = (Get-Date).ToString('o')
|
||||||
|
ConnectionName = $ConnectionName
|
||||||
|
NetlogonRestarted = $restarted
|
||||||
|
SecureChannel = $false
|
||||||
|
Error = $_.Exception.Message
|
||||||
|
} | ConvertTo-Json | Set-Content -LiteralPath $logPath
|
||||||
|
throw
|
||||||
|
}
|
||||||
@@ -0,0 +1,95 @@
|
|||||||
|
[CmdletBinding()]
|
||||||
|
param([switch]$PreferCedNow,[string]$ProvisionXml='')
|
||||||
|
$ErrorActionPreference='Stop'
|
||||||
|
$computer=Get-CimInstance Win32_ComputerSystem
|
||||||
|
if(-not $computer.PartOfDomain -or $computer.DomainRole -ne 1 -or $env:COMPUTERNAME -notmatch '^(AF|SD|SI)-'){return}
|
||||||
|
$destination='C:\ProgramData\LCI-Admin\CED-WiFi'
|
||||||
|
if(-not ('Sgu.CedMachineWifi' -as [type])){
|
||||||
|
Add-Type -ReferencedAssemblies System.dll,System.Xml.dll -TypeDefinition @'
|
||||||
|
using System;
|
||||||
|
using System.Collections.Generic;
|
||||||
|
using System.Collections;
|
||||||
|
using System.Runtime.InteropServices;
|
||||||
|
using System.Text;
|
||||||
|
using System.Xml;
|
||||||
|
namespace Sgu {
|
||||||
|
public class CedWifiResult { public string Interface; public string Ssid; public string Profile; public bool MachineProfileReady; public bool GroupProfileRepaired; public bool MachineProfileCreated; public int OtherProfilesMadeManual; public bool ConnectionRequested; public uint QueryError; }
|
||||||
|
public static class CedMachineWifi {
|
||||||
|
[StructLayout(LayoutKind.Sequential,CharSet=CharSet.Unicode)] struct Connection { public int Mode; [MarshalAs(UnmanagedType.LPWStr)] public string Profile; public IntPtr Ssid; public IntPtr Bssids; public int BssType; public uint Flags; }
|
||||||
|
[StructLayout(LayoutKind.Sequential)] struct Session { public int Id; public IntPtr Name; public int State; }
|
||||||
|
[DllImport("wlanapi.dll")] static extern uint WlanOpenHandle(uint v,IntPtr r,out uint n,out IntPtr h);
|
||||||
|
[DllImport("wlanapi.dll")] static extern uint WlanEnumInterfaces(IntPtr h,IntPtr r,out IntPtr p);
|
||||||
|
[DllImport("wlanapi.dll")] static extern uint WlanGetProfileList(IntPtr h,ref Guid i,IntPtr r,out IntPtr p);
|
||||||
|
[DllImport("wlanapi.dll",CharSet=CharSet.Unicode)] static extern uint WlanGetProfile(IntPtr h,ref Guid i,string name,IntPtr r,out IntPtr xml,ref uint flags,out uint access);
|
||||||
|
[DllImport("wlanapi.dll",CharSet=CharSet.Unicode)] static extern uint WlanSetProfile(IntPtr h,ref Guid i,uint flags,string xml,string security,[MarshalAs(UnmanagedType.Bool)]bool overwrite,IntPtr r,out uint reason);
|
||||||
|
[DllImport("wlanapi.dll",CharSet=CharSet.Unicode)] static extern uint WlanSetProfilePosition(IntPtr h,ref Guid i,string name,uint position,IntPtr r);
|
||||||
|
[DllImport("wlanapi.dll")] static extern uint WlanQueryInterface(IntPtr h,ref Guid i,int opcode,IntPtr r,out uint size,out IntPtr data,out int type);
|
||||||
|
[DllImport("wlanapi.dll")] static extern uint WlanSetInterface(IntPtr h,ref Guid i,int opcode,uint size,ref int data,IntPtr r);
|
||||||
|
[DllImport("wlanapi.dll",CharSet=CharSet.Unicode)] static extern uint WlanConnect(IntPtr h,ref Guid i,ref Connection c,IntPtr r);
|
||||||
|
[DllImport("wlanapi.dll")] static extern uint WlanCloseHandle(IntPtr h,IntPtr r);
|
||||||
|
[DllImport("wlanapi.dll")] static extern void WlanFreeMemory(IntPtr p);
|
||||||
|
[DllImport("wtsapi32.dll",CharSet=CharSet.Unicode,SetLastError=true)] static extern bool WTSEnumerateSessions(IntPtr h,int reserved,int version,out IntPtr list,out int count);
|
||||||
|
[DllImport("wtsapi32.dll",CharSet=CharSet.Unicode)] static extern bool WTSQuerySessionInformation(IntPtr h,int id,int type,out IntPtr data,out int bytes);
|
||||||
|
[DllImport("wtsapi32.dll")] static extern void WTSFreeMemory(IntPtr p);
|
||||||
|
static void Check(uint e){if(e!=0)throw new System.ComponentModel.Win32Exception((int)e);}
|
||||||
|
static XmlDocument Read(IntPtr h,ref Guid id,string name,out uint flags){IntPtr p=IntPtr.Zero;uint access;flags=0;uint e=WlanGetProfile(h,ref id,name,IntPtr.Zero,out p,ref flags,out access);if(e!=0)return null;try{var x=new XmlDocument();x.LoadXml(Marshal.PtrToStringUni(p));return x;}finally{WlanFreeMemory(p);}}
|
||||||
|
static string Text(XmlDocument x,string name){XmlNode n=x.SelectSingleNode("//*[local-name()='"+name+"']");return n==null?"":n.InnerText;}
|
||||||
|
static bool Auto(XmlDocument x){bool changed=false;XmlElement root=x.DocumentElement;XmlNode mode=root.SelectSingleNode("*[local-name()='connectionMode']");if(mode==null)throw new InvalidOperationException("Missing connection mode.");if(mode.InnerText!="auto"){mode.InnerText="auto";changed=true;}XmlNode sw=root.SelectSingleNode("*[local-name()='autoSwitch']");if(sw==null){sw=x.CreateElement("autoSwitch",root.NamespaceURI);root.InsertAfter(sw,mode);changed=true;}if(sw.InnerText!="false"){sw.InnerText="false";changed=true;}return changed;}
|
||||||
|
static void Save(IntPtr h,ref Guid id,uint flags,XmlDocument x){uint reason;uint e=WlanSetProfile(h,ref id,flags,x.OuterXml,null,true,IntPtr.Zero,out reason);if(e!=0)throw new InvalidOperationException("Cannot save WLAN profile: "+e+", reason="+reason);}
|
||||||
|
static void Connected(IntPtr h,ref Guid id,CedWifiResult result){IntPtr p=IntPtr.Zero;uint size;int type;uint e=WlanQueryInterface(h,ref id,7,IntPtr.Zero,out size,out p,out type);result.QueryError=e;try{if(e==0&&size>=556){result.Profile=Marshal.PtrToStringUni(IntPtr.Add(p,8));int len=Marshal.ReadInt32(p,520);if(len>=0&&len<=32){byte[] ssid=new byte[len];Marshal.Copy(IntPtr.Add(p,524),ssid,0,len);result.Ssid=Encoding.UTF8.GetString(ssid);}}}finally{if(p!=IntPtr.Zero)WlanFreeMemory(p);}}
|
||||||
|
static void Connect(IntPtr h,ref Guid id,string name){Connection c=new Connection{Mode=0,Profile=name,BssType=1};Check(WlanConnect(h,ref id,ref c,IntPtr.Zero));}
|
||||||
|
public static int UserSessions(){IntPtr list=IntPtr.Zero;int count,result=0;if(!WTSEnumerateSessions(IntPtr.Zero,0,1,out list,out count))throw new System.ComponentModel.Win32Exception(Marshal.GetLastWin32Error());try{int size=Marshal.SizeOf(typeof(Session));for(int i=0;i<count;i++){Session s=(Session)Marshal.PtrToStructure(IntPtr.Add(list,i*size),typeof(Session));IntPtr p=IntPtr.Zero;int bytes;try{if(WTSQuerySessionInformation(IntPtr.Zero,s.Id,5,out p,out bytes)&&bytes>2&&!String.IsNullOrEmpty(Marshal.PtrToStringUni(p)))result++;}finally{if(p!=IntPtr.Zero)WTSFreeMemory(p);}}}finally{WTSFreeMemory(list);}return result;}
|
||||||
|
public static CedWifiResult[] Ensure(string provision,bool prefer,bool rollback,string prior,IDictionary facts){
|
||||||
|
const string ssid="Centro de Experiencia Digital", backup="CED - Equipo";IntPtr h=IntPtr.Zero,list=IntPtr.Zero;uint v;var results=new List<CedWifiResult>();Check(WlanOpenHandle(2,IntPtr.Zero,out v,out h));
|
||||||
|
try{Check(WlanEnumInterfaces(h,IntPtr.Zero,out list));int count=Marshal.ReadInt32(list);for(int i=0;i<count;i++){Guid id=(Guid)Marshal.PtrToStructure(IntPtr.Add(list,8+i*532),typeof(Guid));var r=new CedWifiResult{Interface=id.ToString()};Connected(h,ref id,r);int interfaceState=Marshal.ReadInt32(list,8+i*532+528);if(r.QueryError==5&&interfaceState==1&&facts!=null&&facts.Contains(id.ToString())){string[] row=facts[id.ToString()] as string[];if(row!=null&&row.Length==2){r.Profile=row[0];r.Ssid=row[1];}}
|
||||||
|
if(rollback){if(!String.IsNullOrEmpty(prior))Connect(h,ref id,prior);results.Add(r);continue;}
|
||||||
|
IntPtr autoData=IntPtr.Zero;uint autoSize;int autoType;try{Check(WlanQueryInterface(h,ref id,1,IntPtr.Zero,out autoSize,out autoData,out autoType));if(Marshal.ReadInt32(autoData)==0){int enabled=1;Check(WlanSetInterface(h,ref id,1,4,ref enabled,IntPtr.Zero));}}finally{if(autoData!=IntPtr.Zero)WlanFreeMemory(autoData);}
|
||||||
|
uint gpFlags;XmlDocument gp=Read(h,ref id,ssid,out gpFlags);
|
||||||
|
if(gp!=null&&(gpFlags&2)==0){bool changed=Auto(gp);if(Text(gp,"protected")=="false")changed=true;if(changed){Save(h,ref id,gpFlags,gp);r.GroupProfileRepaired=true;gp=Read(h,ref id,ssid,out gpFlags);}}
|
||||||
|
uint flags;XmlDocument machine=Read(h,ref id,backup,out flags);
|
||||||
|
if(machine==null){XmlDocument source=null;if(!String.IsNullOrEmpty(provision)){source=new XmlDocument();source.LoadXml(provision);}else if(gp!=null)source=(XmlDocument)gp.CloneNode(true);
|
||||||
|
if(source!=null){if(Text(source,"authentication")!="WPA2PSK"&&Text(source,"authentication")!="WPA3SAE")throw new InvalidOperationException("Expected Personal Wi-Fi profile.");XmlNode ssidNode=source.SelectSingleNode("//*[local-name()='SSID']/*[local-name()='name']");if(ssidNode==null||ssidNode.InnerText!=ssid)throw new InvalidOperationException("Unexpected SSID.");source.DocumentElement.SelectSingleNode("*[local-name()='name']").InnerText=backup;Auto(source);Save(h,ref id,0,source);r.MachineProfileCreated=true;machine=Read(h,ref id,backup,out flags);}
|
||||||
|
}else if(Auto(machine)){Save(h,ref id,flags,machine);machine=Read(h,ref id,backup,out flags);}
|
||||||
|
r.MachineProfileReady=machine!=null&&(flags&2)==0&&Text(machine,"protected")=="true"&&Text(machine,"connectionMode")=="auto";
|
||||||
|
if(r.MachineProfileReady){IntPtr profiles=IntPtr.Zero;try{Check(WlanGetProfileList(h,ref id,IntPtr.Zero,out profiles));int n=Marshal.ReadInt32(profiles),gpCount=0,backupPosition=-1;for(int p=0;p<n;p++){IntPtr item=IntPtr.Add(profiles,8+p*516);string name=Marshal.PtrToStringUni(item);if((Marshal.ReadInt32(item,512)&1)!=0)gpCount++;if(name==backup)backupPosition=p;uint f;XmlDocument other=Read(h,ref id,name,out f);if(other==null||f!=0)continue;XmlNode sn=other.SelectSingleNode("//*[local-name()='SSID']/*[local-name()='name']");XmlNode mode=other.DocumentElement.SelectSingleNode("*[local-name()='connectionMode']");if(sn!=null&&sn.InnerText!=ssid&&mode!=null&&mode.InnerText=="auto"){mode.InnerText="manual";Save(h,ref id,f,other);r.OtherProfilesMadeManual++;}}if(backupPosition!=gpCount)Check(WlanSetProfilePosition(h,ref id,backup,(uint)gpCount,IntPtr.Zero));}finally{if(profiles!=IntPtr.Zero)WlanFreeMemory(profiles);}
|
||||||
|
if((prefer&&r.Ssid!=ssid)||(String.IsNullOrEmpty(r.Ssid)&&r.QueryError==5023)){Connect(h,ref id,backup);r.ConnectionRequested=true;}
|
||||||
|
}
|
||||||
|
results.Add(r);
|
||||||
|
}}finally{if(list!=IntPtr.Zero)WlanFreeMemory(list);WlanCloseHandle(h,IntPtr.Zero);}return results.ToArray();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
'@
|
||||||
|
}
|
||||||
|
function Get-CedConnectionFacts {
|
||||||
|
$facts=@{};$events=@()
|
||||||
|
try{$events=@(Get-WinEvent -FilterHashtable @{LogName='Microsoft-Windows-WLAN-AutoConfig/Operational';Id=8001,8003} -MaxEvents 64 -ErrorAction Stop)}catch{}
|
||||||
|
foreach($event in $events){
|
||||||
|
[xml]$xml=$event.ToXml();$data=$xml.Event.EventData.Data
|
||||||
|
$interface=[string]($data|Where-Object Name -eq InterfaceGuid).'#text'
|
||||||
|
if(-not $interface){continue};$key=([guid]$interface).ToString()
|
||||||
|
if($facts.ContainsKey($key)){continue}
|
||||||
|
if($event.Id -eq 8001){$facts[$key]=[string[]]@([string]($data|Where-Object Name -eq ProfileName).'#text',[string]($data|Where-Object Name -eq SSID).'#text')}else{$facts[$key]=[string[]]@('','')}
|
||||||
|
}
|
||||||
|
return ,$facts
|
||||||
|
}
|
||||||
|
$before=@([Sgu.CedMachineWifi]::Ensure($ProvisionXml,[bool]$PreferCedNow,$false,'',(Get-CedConnectionFacts)))
|
||||||
|
$ProvisionXml=$null
|
||||||
|
$requested=@($before|Where-Object ConnectionRequested).Count -gt 0
|
||||||
|
$rolledBack=$false
|
||||||
|
if($requested){
|
||||||
|
for($attempt=0;$attempt -lt 10;$attempt++){
|
||||||
|
Start-Sleep -Seconds 2
|
||||||
|
$state=@([Sgu.CedMachineWifi]::Ensure('',$false,$false,'',(Get-CedConnectionFacts)))
|
||||||
|
if($state.Ssid -contains 'Centro de Experiencia Digital'){break}
|
||||||
|
}
|
||||||
|
if($PreferCedNow -and $state.Ssid -notcontains 'Centro de Experiencia Digital'){
|
||||||
|
foreach($prior in $before|Where-Object Profile){[void][Sgu.CedMachineWifi]::Ensure('',$false,$true,$prior.Profile,(Get-CedConnectionFacts))}
|
||||||
|
$rolledBack=$true
|
||||||
|
}
|
||||||
|
}else{$state=$before}
|
||||||
|
$network=& (Join-Path $PSScriptRoot 'Set-SguCedClientNetwork.ps1') -ConnectedInterface @($state.Interface) -ConnectedSsid @($state.Ssid)
|
||||||
|
if($requested -and -not $rolledBack){Register-DnsClient -ErrorAction SilentlyContinue}
|
||||||
|
$result=[pscustomobject]@{Utc=[DateTime]::UtcNow.ToString('o');Computer=[string]$env:COMPUTERNAME;Identity=[string][Security.Principal.WindowsIdentity]::GetCurrent().Name;UserSessions=[Sgu.CedMachineWifi]::UserSessions();MachineProfileReady=(@($state|Where-Object MachineProfileReady).Count -gt 0);ConnectedToCed=($state.Ssid -contains 'Centro de Experiencia Digital');RolledBack=$rolledBack;Interfaces=@($state|Select-Object Interface,Ssid,Profile,MachineProfileReady,GroupProfileRepaired,MachineProfileCreated,OtherProfilesMadeManual,ConnectionRequested,QueryError);PeriodicPolling=$false}
|
||||||
|
if(Test-Path -LiteralPath $destination){$result|ConvertTo-Json -Depth 5|Set-Content -LiteralPath(Join-Path $destination 'machine-wifi-status.json') -Encoding UTF8}
|
||||||
|
$result
|
||||||
Loaded 100 of 161 files, more files were not shown because too many files have changed in this diff.
Show more
Reference in new issue
Block a user