Ga naar inhoud

In het kader van een eerste installatie

Installatie van Systancia Identity (SID)

CyberElements Identity wordt geïnstalleerd met het script Installation.ps1 dat in de bronmap is opgenomen.

De stappen van het installatiescript zijn:

  • De oude versie verwijderen (geldig vanaf versie 7.0);
  • De oude applicatie installeren (stille uitvoering van InstallShield);
  • De nieuwe applicatie en de API's Identity en Federation installeren;
  • De sites toewijzen aan de https-poorten.

Bewerk vóór het uitvoeren van het script het bestand Installation.ps1 in de bronmap.

Vervang de waarden van de bestaande parameters en voeg de nodige parameters toe.

Verplichte parameters:

  • AccountSid: aanmeldnaam van het serviceaccount SID (gekoppeld aan de Identity-API en aan de interfaces van de nieuwe generatie van versie 7). Dit account moet over sysadmin-rechten op de database-instantie beschikken.
  • PasswordSid: wachtwoord van het serviceaccount SID (gekoppeld aan de Identity-API en aan de interfaces van de nieuwe generatie van versie 7).
  • HostName: volledige naam van de server + domein (voorbeeld: xxx).
  • AccountHP: aanmeldnaam van het serviceaccount Hpliance (gekoppeld aan de interfaces van de oudere generatie van versie 6).
  • PasswordHP: wachtwoord van het serviceaccount Hpliance (gekoppeld aan de interfaces van de oudere generatie van versie 6).
  • DbIpAddress: server en naam van de database-instantie.
  • LicencePath: pad waar het bestand licence.lic zich bevindt.

Optionele parameters:

  • InstallPath: doelmap voor de installatie van CyberElements Identity. Als deze niet is opgegeven, wordt de standaardwaarde ”C:\Program Files (x86)\Systancia” gebruikt.
  • InstallPath64: doelmap voor de installatie in de map X64 van de oude applicaties. Als deze niet is opgegeven, wordt de standaardwaarde ”C:\Program Files\Systancia” gebruikt.
  • CertName: weergavenaam van het domeincertificaat. Optioneel als deze gelijk is aan HostName.
  • AuditServer: IP-adres van de auditserver. De standaardwaarde is ”127.0.0.1”.
  • SmtpServer: IP-adres van de SMTP-server. Standaard leeg.
  • SmtpMail: e-mailadres van de bestemming. Standaard leeg.

Voer het script Installation.ps1 uit met een beheerdersaccount.

Wijzig de volgende parameters in de tabel [Hpliance][dbo][CONFIGURATION] door het IP-adres te vervangen door de volledige naam van de server (equivalent aan de parameter HostName):

  • API_URL: https://[HostName]:44345
  • IDP_URL: https://[HostName]:44350
  • WEB_URL: https://[HostName]:44340

Als het script zonder fouten is uitgevoerd, open dan de IIS-manager en selecteer de map ”Sites”.

Selecteer de site Systancia.Federation en klik op de URL om de aanmeldpagina weer te geven.

Deze bewerking rondt de installatie van het onderdeel Federation af door de database aan te maken.

Als de aanmeldpagina wordt geopend, is de installatie afgerond en zijn er geen fouten opgetreden.

Als de naam van het certificaat verschilt van de naam van de server, genereert de site Systancia.Federation bij het openen een fout.

In dat geval moeten er handmatige wijzigingen worden aangebracht in de database Systancia.Federation.

Voer de volgende query's uit:

1
2
3
4
5
DECLARE @currentHostName as nvarchar(max) = 'https://localhost:'
DECLARE @newHostName as nvarchar(max) = 'https://localhost:'
UPDATE [dbo].[Clients] SET ClientUri = REPLACE(ClientUri, @currentHostName, @newHostName)
UPDATE [dbo].[ClientRedirectUris] SET RedirectUri = REPLACE(RedirectUri, @currentHostName, @newHostName)
UPDATE [dbo].[ClientPostLogoutRedirectUris] SET PostLogoutRedirectUri = REPLACE(PostLogoutRedirectUri, @currentHostName, @newHostName)

Installatie van de provisioning-engine Identity (SIP)

De provisioning-engine CyberElements Identity Provisioning (SIP) wordt geïnstalleerd met het script SipSetup.ps1 dat in de bronmap is opgenomen.

De uit te voeren opdrachtregel staat in het bestand README.txt van de bronmap.

Vervang de waarden van de volgende parameters:

  • InstallPath: doelmap van de installatie van CyberElements Identity
  • AccountService: aanmeldnaam van het serviceaccount SIP (gekoppeld aan de API).
  • AccountPassword: wachtwoord van het serviceaccount SIP (gekoppeld aan de API).
  • Authority: vervang [AuthorityServ] in de URL door de volledige naam van het domeincertificaat van de SIP-server
  • Certificate: weergavenaam van het domeincertificaat
  • HostName: volledige naam van de server + domein (voorbeeld: xxx)
  • ApiUrl: vervang [SidApiServer] in de URL door de volledige naam van het domeincertificaat van de SID-server (Identity-API)

Voer het script uit met een beheerdersaccount.

Schrijfmachtigingen in de SIP-mappen worden standaard alleen aan het serviceaccount SIP gegeven. U kunt deze rechten desgewenst handmatig aan andere accounts toevoegen (bijvoorbeeld aan het serviceaccount waaronder de oude interfaces worden uitgevoerd, als u workflows uitvoert met taken die scripts aanroepen die aanroepen van provisioning-sequenties bevatten).

Als aanbevolen werkwijze moeten alle aanroepen van provisioning-sequenties via webservices verlopen, zodat alleen het serviceaccount SIP ze uitvoert.