Logging ITfoxtec AD FS Audit
O ITfoxtec AD FS Audit regista em Application ("Windows Logs/Application") no Event Log com origem de log: "AD FS, ITfoxtec Auditing".
Os detalhes do logging são encontrados no separador Details.
| ID do evento |
Texto |
| 211 |
"Received, SAML GET Request" or "Received, SAML Authn Request" |
| 212 |
"Send, SAML GET Request" or "Send, SAML Authn Request" |
| 221 |
"Send/Received, SAML Assertion" |
| 222 |
"Received, Validating SAML Assertion" |
| 231 |
"Send/Received, SAML Logout Request" |
| 232 |
"Send/Received, SAML Logout Response" |
| 233 |
"Send/Received, SAML Logout Response" |
| 234 |
"Received, SAML Logout Response" |
| 235 |
"Received, SAML Logout Request" |
| 236 |
"Received, SAML Logout Request" |
| 237 |
"Send, SAML Logout Request" |
Instalação do ITfoxtec AD FS Audit
O ITfoxtec AD FS Audit é instalado no servidor AD FS criando uma origem de log, colocando uma DLL na pasta AD FS no servidor e configurando o ITfoxtec AD FS Audit no ficheiro de configuração do AD FS. A instalação é realizada numa farm AD FS em todos os servidores AD FS.
Nota: só é necessário criar uma origem de log a primeira vez que o ITfoxtec AD FS Audit é instalado. Para a primeira instalação não é necessário iniciar e parar o serviço AD FS; isso só é necessário para atualizações.
1) Criar uma origem de log
É criada uma origem de log chamada "AD FS, ITfoxtec Auditing" no log Application.
Execute o seguinte num CMD com privilégios administrativos: ITfoxtec.CreateAuditingEventSource.exe
É criada uma entrada de teste no Event Log, que pode ser verificada.
2) Parar o serviço AD FS
Parar o serviço Active Directory Federation Services. Por exemplo, com o comando: "net stop adfssrv"
3) Colocar a DLL ITfoxtec AD FS Audit na pasta AD FS
Copie o ficheiro "ITfoxtec.AdfsAuditing.dll" para a pasta "C:\Windows\ADFS".
4) Configurar o ITfoxtec AD FS Audit
A configuração do ITfoxtec AD FS Audit é adicionada sob o elemento "system.diagnostics" no ficheiro de configuração do AD FS: "C:\Windows\ADFS\Microsoft.IdentityServer.Servicehost.exe.config"
A configuração do ITfoxtec AD FS Audit é adicionada sob o elemento "system.diagnostics" no ficheiro de configuração do AD FS "Microsoft.IdentityServer.Servicehost.exe.config" na pasta "C:\Windows\ADFS".
O elemento "system.diagnostics" original do AD FS 3.0:
<system.diagnostics>
<sources>
<source name="Microsoft.IdentityModel" switchValue="Off">
<listeners>
<add name="ADFSWifListener" traceOutputOptions="ProcessId,ThreadId" initializeData="Wif" type="Microsoft.IdentityServer.Diagnostics.ADFSTraceListener,Microsoft.IdentityServer.Diagnostics,Version=6.3.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35, processorArchitecture=MSIL" />
</listeners>
</source>
<source name="System.ServiceModel" switchValue="Off">
<listeners>
<add name="ADFSWcfListener" traceOutputOptions="ProcessId,ThreadId" initializeData="Wcf" type="Microsoft.IdentityServer.Diagnostics.ADFSTraceListener,Microsoft.IdentityServer.Diagnostics,Version=6.3.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35, processorArchitecture=MSIL" />
</listeners>
</source>
<source name="System.ServiceModel.MessageLogging" switchValue="Off">
<listeners>
<add name="ADFSWcfListener" traceOutputOptions="ProcessId,ThreadId" initializeData="Wcf" type="Microsoft.IdentityServer.Diagnostics.ADFSTraceListener,Microsoft.IdentityServer.Diagnostics,Version=6.3.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35, processorArchitecture=MSIL" />
</listeners>
</source>
</sources>
<trace autoflush="true" ></trace>
</system.diagnostics>
O ITfoxtec AD FS Audit é configurado no elemento "system.diagnostics". A configuração está destacada a amarelo:
<system.diagnostics>
<sources>
<source name="Microsoft.IdentityModel" switchValue="Verbose">
<listeners>
<add name="EventLogIdentityModelListener" type="ITfoxtec.AdfsAuditing.EventLogIdentityModelListener, ITfoxtec.AdfsAuditing, Version=1.0.0.0, Culture=neutral, PublicKeyToken=b2673fdcc9b2bfae" />
<!--<add name="ADFSWifListener" traceOutputOptions="ProcessId,ThreadId" initializeData="Wif" type="Microsoft.IdentityServer.Diagnostics.ADFSTraceListener,Microsoft.IdentityServer.Diagnostics,Version=6.3.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35, processorArchitecture=MSIL" />-->
</listeners>
</source>
<source name="System.Net.HttpListener" tracemode="protocolonly" maxdatasize="10000" switchValue="Verbose">
<listeners>
<add name="EventLogHttpListener" type="ITfoxtec.AdfsAuditing.EventLogHttpListener, ITfoxtec.AdfsAuditing, Version=1.0.0.0, Culture=neutral, PublicKeyToken=b2673fdcc9b2bfae" />
</listeners>
</source>
<source name="System.ServiceModel" switchValue="Off">
<listeners>
<add name="ADFSWcfListener" traceOutputOptions="ProcessId,ThreadId" initializeData="Wcf" type="Microsoft.IdentityServer.Diagnostics.ADFSTraceListener,Microsoft.IdentityServer.Diagnostics,Version=6.3.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35, processorArchitecture=MSIL" />
</listeners>
</source>
<source name="System.ServiceModel.MessageLogging" switchValue="Off">
<listeners>
<add name="ADFSWcfListener" traceOutputOptions="ProcessId,ThreadId" initializeData="Wcf" type="Microsoft.IdentityServer.Diagnostics.ADFSTraceListener,Microsoft.IdentityServer.Diagnostics,Version=6.3.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35, processorArchitecture=MSIL" />
</listeners>
</source>
</sources>
<trace autoflush="true" ></trace>
</system.diagnostics>
A configuração do ITfoxtec AD FS Audit como ficheiro de texto.
5) Iniciar o serviço AD FS
Inicie o serviço Active Directory Federation Services. Por exemplo, com o comando: "net start adfssrv"