@microsoft/windows-admin-center-sdk
Version:
Microsoft - Windows Admin Center Shell
635 lines (632 loc) • 33.3 kB
JavaScript
import { forkJoin, from, of, throwError } from 'rxjs';
import { catchError, switchMap } from 'rxjs/operators';
import { Net } from '../data/net';
import { PowerShell } from '../data/powershell';
import { LogLevel } from '../diagnostics/log-level';
import { Logging } from '../diagnostics/logging';
import { SmeWebTelemetry } from '../diagnostics/sme-web-telemetry';
import { TelemetryEventStates } from '../diagnostics/sme-web-telemetry-models';
import { EnvironmentModule } from '../manifest/environment-modules';
import { RpcWorkItemSubjectServer } from '../rpc/work-item/rpc-work-item-subject-server';
import { NotificationState } from './notification-state';
import { PowerShellNotification } from './powershell-notification';
import { WorkItemRequestType } from './work-item-request';
/**
* Work item manager class.
*/
export class WorkItemManager {
rpc;
gatewayConnection;
nodeConnection;
notificationConnection;
static apiWorkItems24hours = '/workitems?lastMinutes=1440';
static apiNotificationMessageStored = '/NotificationMessage/stored';
static apiNotificationMessageSubscriptionId = '/NotificationMessage/id';
active = false;
startSubscription;
powerShellNotification;
notificationSubscription;
rpcWorkItemSubscription;
notificationManager;
sequenceCounter = 1;
sequencePackets = {};
rpcWorkItemSubjectServer;
rootSubscriptionId;
/**
* Initializes a new instance of the WorkItemManager class.
*
* @param rpc the RPC object.
* @param gatewayConnection the gateway connection service.
* @param nodeConnection the node connection service.
* @param notificationManager the notification manager.
*/
constructor(rpc, gatewayConnection, nodeConnection, notificationConnection) {
this.rpc = rpc;
this.gatewayConnection = gatewayConnection;
this.nodeConnection = nodeConnection;
this.notificationConnection = notificationConnection;
this.notificationManager = this.notificationConnection.notificationManager;
this.start();
}
/**
* Start the work item management.
*/
start() {
this.stop();
this.rpcWorkItemSubjectServer = new RpcWorkItemSubjectServer(this.rpc);
this.active = true;
// pickup active work items for last 24hours
this.startSubscription = this.gatewayConnection.get(WorkItemManager.apiWorkItems24hours)
.pipe(catchError((error) => {
const message = MsftSme.getStrings().MsftSmeShell.Core.Error.NotificationNoWorkItemFound.message;
Logging.logError('Notification', message.format(Net.getErrorMessage(error)));
return of({ response: { value: null } });
}), switchMap(response => {
if (response.value) {
response.value.forEach(element => this.notificationManager.addFromRecover(element));
}
// start websocket status query.
this.powerShellNotification = new PowerShellNotification(this.gatewayConnection.gatewayUrl);
return from(this.powerShellNotification.initialize());
}))
.subscribe({
next: () => {
// notification from the gateway...
this.notificationSubscription = this.powerShellNotification.subject
.subscribe(item => {
const message = item.message;
if (message && message.sessionId) {
// PowerShell Work Item message.
const workItem = message;
const psSessionId = workItem.sessionId;
// Pass in psSessionId so telemetry can search up the PSCommand for this
if (PowerShellNotification.hasError(item)) {
SmeWebTelemetry.tracePowershellEvent(null, TelemetryEventStates.Error, { response: workItem, id: psSessionId });
}
else if (PowerShellNotification.hasCompleted(item)) {
SmeWebTelemetry.removePowershellId(psSessionId);
}
if (!this.notificationManager.updateFromMessage(psSessionId, item)) {
const unexpectedMessage = MsftSme.getStrings().MsftSmeShell.Core.Error.NotificationUnexpectedReceived.message;
Logging.log({
source: 'Notification', level: LogLevel.Warning, message: unexpectedMessage.format(psSessionId)
});
}
}
else if (message && message.id) {
// PowerShell Work Item message.
const notification = message;
const state = this.getErrorLevel(notification);
// Pass in psSessionId so telemetry can search up the PSCommand for this
if (state === NotificationState.Error) {
SmeWebTelemetry.tracePowershellEvent(null, TelemetryEventStates.Error, { response: message, id: message.id });
}
else if (state === NotificationState.Success) {
SmeWebTelemetry.removePowershellId(message.id);
}
if (this.notificationManager.addForNotificationMessage(state, notification)) {
this.powerShellNotification.subscribeSession(notification.id);
}
if (!this.notificationManager.updateFromNotificationMessage(state, message)) {
const unexpectedMessage = MsftSme.getStrings().MsftSmeShell.Core.Error.NotificationUnexpectedReceived.message;
Logging.logWarning('Notification', unexpectedMessage.format(message.id));
}
}
});
if (EnvironmentModule.isGatewayV200) {
this.notificationSubscription.add(forkJoin([
this.gatewayConnection.get(WorkItemManager.apiNotificationMessageSubscriptionId),
this.gatewayConnection.get(WorkItemManager.apiNotificationMessageStored)
]).subscribe(([idData, storedData]) => {
this.rootSubscriptionId = idData.id;
this.powerShellNotification.subscribeSession(this.rootSubscriptionId);
storedData.value.forEach(element => {
const state = this.getErrorLevel(element);
this.notificationManager.addForNotificationMessage(state, element);
this.powerShellNotification.subscribeSession(element.id);
});
}));
}
// workItem request from rpc...
this.rpcWorkItemSubscription = this.rpcWorkItemSubjectServer.subject
.subscribe(item => {
switch (item.data.type) {
// legacy support for quick submission. it was expected 3 seconds response.
case WorkItemRequestType.PowerShellSubmit:
this.submitWorkItem(item.data).toPromise().then(item.deferred.resolve, item.deferred.reject);
break;
// new support for longer submission case like manage-as dialog displays.
case WorkItemRequestType.WorkItemSubmit:
const submitSequenceId = this.sequenceCounter++;
item.data.sequenceId = submitSequenceId;
this.submitWorkItem(item.data)
.subscribe({
next: data => this.sequencePackets[submitSequenceId] = { success: true, data: data },
error: error => this.sequencePackets[submitSequenceId] = { success: false, data: error }
});
// using sequence id, submission return immediately.
item.deferred.resolve({ sequenceId: submitSequenceId, id: null });
break;
// query to notification by 'id' or query to submission result by 'sequenceId'.
case WorkItemRequestType.StateQuery:
default:
if (item.data.id) {
// query to 'id'
this.queryWorkItem(item.data).toPromise().then(item.deferred.resolve, item.deferred.reject);
}
else {
// query to 'sequenceId'
const querySequenceId = item.data.sequenceId;
const result = this.sequencePackets[querySequenceId];
if (result) {
// have a result, delete it and pass back as response.
delete this.sequencePackets[querySequenceId];
if (result.success) {
item.deferred.resolve(result.data);
}
else {
item.deferred.reject(result.data);
}
}
else {
// no result yet.
item.deferred.resolve({ sequenceId: querySequenceId, id: null });
}
}
break;
}
});
// subscribe the session notification to the gateway...
this.notificationManager.items.forEach((value) => {
// only if it's not finalized.
if (value.state === NotificationState.Started || value.state === NotificationState.InProgress) {
this.powerShellNotification.subscribeSession(value.id);
}
});
},
error: error => {
const message = MsftSme.getStrings().MsftSmeShell.Core.Error.NotificationWebsocketInitialize.message;
Logging.log({
source: 'Notification',
level: LogLevel.Error,
message: message.format(Net.getErrorMessage(error))
});
}
});
}
/**
* Stop the work item management.
*/
stop() {
this.active = false;
if (this.startSubscription) {
this.startSubscription.unsubscribe();
this.startSubscription = null;
}
if (this.notificationSubscription) {
this.notificationSubscription.unsubscribe();
this.notificationSubscription = null;
}
if (this.powerShellNotification) {
this.powerShellNotification.uninitialize();
this.powerShellNotification = null;
}
if (this.rpcWorkItemSubscription) {
this.rpcWorkItemSubscription.unsubscribe();
this.rpcWorkItemSubscription = null;
}
}
/**
* Create and submit a workItem.
*
* @param request the work item request.
* @return Observable the WorkItemResult observable.
*/
submitWorkItem(request) {
let command = null;
const notificationId = request.id || MsftSme.newGuid();
if (request.powerShellCommand || request.powerShellScript) {
// For a non-powershell long running task (eg: azure site recovery setup), command is null.
command = PowerShell.getPowerShellCommand(request.powerShellCommand || request.powerShellScript);
}
if (request.powerShellScript) {
delete request['powerShellScript'];
}
if (request.powerShellCommand) {
delete request['powerShellCommand'];
}
const nodeRequestOptions = PowerShell.newEndpointOptions(request.nodeRequestOptions);
if (request.nodeRequestOptions) {
delete request['nodeRequestOptions'];
}
// remember current URL where original request generated.
request.locationPathname = window.location.pathname;
request.locationSearch = window.location.search;
// send submit notification
this.notificationManager.addFromWorkItem(notificationId, request, request.startedMessage ? NotificationState.Started : NotificationState.InProgress);
return this.powerShellNotification.submit(this.nodeConnection, request.nodeName, command, request, nodeRequestOptions, result => {
if (!this.notificationManager.updateWorkItemWithPsSession(notificationId, result.id, request, result.state, result.error)) {
const message = MsftSme.getStrings()
.MsftSmeShell.Core.Error.NotificationUnexpectedReceived.message;
Logging.log({
source: 'Notification',
level: LogLevel.Warning,
message: message.format(notificationId)
});
}
});
}
/**
* Query a workItem.
*
* @param request the work item request.
* @return Observable the WorkItemResult observable.
*/
queryWorkItem(request) {
const notification = this.notificationManager.find(request.id);
if (notification) {
if (notification.state === NotificationState.Error) {
return of({
id: notification.id,
state: notification.state,
percent: notification.progressPercent,
error: notification.object
});
}
return of({
id: notification.id,
state: notification.state,
percent: notification.progressPercent,
object: notification.object
});
}
const message = MsftSme.getStrings().MsftSmeShell.Core.Error.NotificationNoIdFound.message;
return throwError(() => message.format(request.id));
}
getErrorLevel(notification) {
switch (notification.errorLevel) {
// Notification is unknown.
case 0:
case 'None':
return NotificationState.Informational;
// Notification is in progress. (non-terminated message.)
case 1:
case 'InProgress':
return NotificationState.InProgress;
// Notification is success. (terminated message.)
case 2:
case 'Success':
return NotificationState.Success;
// Notification is informational. (terminated message.)
case 3:
case 'Informational':
return NotificationState.Informational;
// Notification is warning. (terminated message.)
case 4:
case 'Warning':
return NotificationState.Warning;
// Notification is error. (terminated message.)
case 5:
case 'Error':
return NotificationState.Error;
// Notification is unknown.
default:
throw new Error('Couldn\'t get expected error level from a message notification.');
}
}
}
//# sourceMappingURL=work-item-manager.js.map
// SIG // Begin signature block
// SIG // MIIoKAYJKoZIhvcNAQcCoIIoGTCCKBUCAQExDzANBglg
// SIG // hkgBZQMEAgEFADB3BgorBgEEAYI3AgEEoGkwZzAyBgor
// SIG // BgEEAYI3AgEeMCQCAQEEEBDgyQbOONQRoqMAEEvTUJAC
// SIG // AQACAQACAQACAQACAQAwMTANBglghkgBZQMEAgEFAAQg
// SIG // EfVWThebLq4omfTeT0xPrHtBdRkutnlxt4XjPbl4Dnig
// SIG // gg12MIIF9DCCA9ygAwIBAgITMwAABARsdAb/VysncgAA
// SIG // AAAEBDANBgkqhkiG9w0BAQsFADB+MQswCQYDVQQGEwJV
// SIG // UzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMH
// SIG // UmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBv
// SIG // cmF0aW9uMSgwJgYDVQQDEx9NaWNyb3NvZnQgQ29kZSBT
// SIG // aWduaW5nIFBDQSAyMDExMB4XDTI0MDkxMjIwMTExNFoX
// SIG // DTI1MDkxMTIwMTExNFowdDELMAkGA1UEBhMCVVMxEzAR
// SIG // BgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1v
// SIG // bmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlv
// SIG // bjEeMBwGA1UEAxMVTWljcm9zb2Z0IENvcnBvcmF0aW9u
// SIG // MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA
// SIG // tCg32mOdDA6rBBnZSMwxwXegqiDEUFlvQH9Sxww07hY3
// SIG // w7L52tJxLg0mCZjcszQddI6W4NJYb5E9QM319kyyE0l8
// SIG // EvA/pgcxgljDP8E6XIlgVf6W40ms286Cr0azaA1f7vaJ
// SIG // jjNhGsMqOSSSXTZDNnfKs5ENG0bkXeB2q5hrp0qLsm/T
// SIG // WO3oFjeROZVHN2tgETswHR3WKTm6QjnXgGNj+V6rSZJO
// SIG // /WkTqc8NesAo3Up/KjMwgc0e67x9llZLxRyyMWUBE9co
// SIG // T2+pUZqYAUDZ84nR1djnMY3PMDYiA84Gw5JpceeED38O
// SIG // 0cEIvKdX8uG8oQa047+evMfDRr94MG9EWwIDAQABo4IB
// SIG // czCCAW8wHwYDVR0lBBgwFgYKKwYBBAGCN0wIAQYIKwYB
// SIG // BQUHAwMwHQYDVR0OBBYEFPIboTWxEw1PmVpZS+AzTDwo
// SIG // oxFOMEUGA1UdEQQ+MDykOjA4MR4wHAYDVQQLExVNaWNy
// SIG // b3NvZnQgQ29ycG9yYXRpb24xFjAUBgNVBAUTDTIzMDAx
// SIG // Mis1MDI5MjMwHwYDVR0jBBgwFoAUSG5k5VAF04KqFzc3
// SIG // IrVtqMp1ApUwVAYDVR0fBE0wSzBJoEegRYZDaHR0cDov
// SIG // L3d3dy5taWNyb3NvZnQuY29tL3BraW9wcy9jcmwvTWlj
// SIG // Q29kU2lnUENBMjAxMV8yMDExLTA3LTA4LmNybDBhBggr
// SIG // BgEFBQcBAQRVMFMwUQYIKwYBBQUHMAKGRWh0dHA6Ly93
// SIG // d3cubWljcm9zb2Z0LmNvbS9wa2lvcHMvY2VydHMvTWlj
// SIG // Q29kU2lnUENBMjAxMV8yMDExLTA3LTA4LmNydDAMBgNV
// SIG // HRMBAf8EAjAAMA0GCSqGSIb3DQEBCwUAA4ICAQCI5g/S
// SIG // KUFb3wdUHob6Qhnu0Hk0JCkO4925gzI8EqhS+K4umnvS
// SIG // BU3acsJ+bJprUiMimA59/5x7WhJ9F9TQYy+aD9AYwMtb
// SIG // KsQ/rst+QflfML+Rq8YTAyT/JdkIy7R/1IJUkyIS6srf
// SIG // G1AKlX8n6YeAjjEb8MI07wobQp1F1wArgl2B1mpTqHND
// SIG // lNqBjfpjySCScWjUHNbIwbDGxiFr93JoEh5AhJqzL+8m
// SIG // onaXj7elfsjzIpPnl8NyH2eXjTojYC9a2c4EiX0571Ko
// SIG // mhENF3RtR25A7/X7+gk6upuE8tyMy4sBkl2MUSF08U+E
// SIG // 2LOVcR8trhYxV1lUi9CdgEU2CxODspdcFwxdT1+G8YNc
// SIG // gzHyjx3BNSI4nOZcdSnStUpGhCXbaOIXfvtOSfQX/UwJ
// SIG // oruhCugvTnub0Wna6CQiturglCOMyIy/6hu5rMFvqk9A
// SIG // ltIJ0fSR5FwljW6PHHDJNbCWrZkaEgIn24M2mG1M/Ppb
// SIG // /iF8uRhbgJi5zWxo2nAdyDBqWvpWxYIoee/3yIWpquVY
// SIG // cYGhJp/1I1sq/nD4gBVrk1SKX7Do2xAMMO+cFETTNSJq
// SIG // fTSSsntTtuBLKRB5mw5qglHKuzapDiiBuD1Zt4QwxA/1
// SIG // kKcyQ5L7uBayG78kxlVNNbyrIOFH3HYmdH0Pv1dIX/Mq
// SIG // 7avQpAfIiLpOWwcbjzCCB3owggVioAMCAQICCmEOkNIA
// SIG // AAAAAAMwDQYJKoZIhvcNAQELBQAwgYgxCzAJBgNVBAYT
// SIG // AlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQH
// SIG // EwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29y
// SIG // cG9yYXRpb24xMjAwBgNVBAMTKU1pY3Jvc29mdCBSb290
// SIG // IENlcnRpZmljYXRlIEF1dGhvcml0eSAyMDExMB4XDTEx
// SIG // MDcwODIwNTkwOVoXDTI2MDcwODIxMDkwOVowfjELMAkG
// SIG // A1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAO
// SIG // BgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29m
// SIG // dCBDb3Jwb3JhdGlvbjEoMCYGA1UEAxMfTWljcm9zb2Z0
// SIG // IENvZGUgU2lnbmluZyBQQ0EgMjAxMTCCAiIwDQYJKoZI
// SIG // hvcNAQEBBQADggIPADCCAgoCggIBAKvw+nIQHC6t2G6q
// SIG // ghBNNLrytlghn0IbKmvpWlCquAY4GgRJun/DDB7dN2vG
// SIG // EtgL8DjCmQawyDnVARQxQtOJDXlkh36UYCRsr55JnOlo
// SIG // XtLfm1OyCizDr9mpK656Ca/XllnKYBoF6WZ26DJSJhIv
// SIG // 56sIUM+zRLdd2MQuA3WraPPLbfM6XKEW9Ea64DhkrG5k
// SIG // NXimoGMPLdNAk/jj3gcN1Vx5pUkp5w2+oBN3vpQ97/vj
// SIG // K1oQH01WKKJ6cuASOrdJXtjt7UORg9l7snuGG9k+sYxd
// SIG // 6IlPhBryoS9Z5JA7La4zWMW3Pv4y07MDPbGyr5I4ftKd
// SIG // gCz1TlaRITUlwzluZH9TupwPrRkjhMv0ugOGjfdf8NBS
// SIG // v4yUh7zAIXQlXxgotswnKDglmDlKNs98sZKuHCOnqWbs
// SIG // YR9q4ShJnV+I4iVd0yFLPlLEtVc/JAPw0XpbL9Uj43Bd
// SIG // D1FGd7P4AOG8rAKCX9vAFbO9G9RVS+c5oQ/pI0m8GLhE
// SIG // fEXkwcNyeuBy5yTfv0aZxe/CHFfbg43sTUkwp6uO3+xb
// SIG // n6/83bBm4sGXgXvt1u1L50kppxMopqd9Z4DmimJ4X7Iv
// SIG // hNdXnFy/dygo8e1twyiPLI9AN0/B4YVEicQJTMXUpUMv
// SIG // dJX3bvh4IFgsE11glZo+TzOE2rCIF96eTvSWsLxGoGyY
// SIG // 0uDWiIwLAgMBAAGjggHtMIIB6TAQBgkrBgEEAYI3FQEE
// SIG // AwIBADAdBgNVHQ4EFgQUSG5k5VAF04KqFzc3IrVtqMp1
// SIG // ApUwGQYJKwYBBAGCNxQCBAweCgBTAHUAYgBDAEEwCwYD
// SIG // VR0PBAQDAgGGMA8GA1UdEwEB/wQFMAMBAf8wHwYDVR0j
// SIG // BBgwFoAUci06AjGQQ7kUBU7h6qfHMdEjiTQwWgYDVR0f
// SIG // BFMwUTBPoE2gS4ZJaHR0cDovL2NybC5taWNyb3NvZnQu
// SIG // Y29tL3BraS9jcmwvcHJvZHVjdHMvTWljUm9vQ2VyQXV0
// SIG // MjAxMV8yMDExXzAzXzIyLmNybDBeBggrBgEFBQcBAQRS
// SIG // MFAwTgYIKwYBBQUHMAKGQmh0dHA6Ly93d3cubWljcm9z
// SIG // b2Z0LmNvbS9wa2kvY2VydHMvTWljUm9vQ2VyQXV0MjAx
// SIG // MV8yMDExXzAzXzIyLmNydDCBnwYDVR0gBIGXMIGUMIGR
// SIG // BgkrBgEEAYI3LgMwgYMwPwYIKwYBBQUHAgEWM2h0dHA6
// SIG // Ly93d3cubWljcm9zb2Z0LmNvbS9wa2lvcHMvZG9jcy9w
// SIG // cmltYXJ5Y3BzLmh0bTBABggrBgEFBQcCAjA0HjIgHQBM
// SIG // AGUAZwBhAGwAXwBwAG8AbABpAGMAeQBfAHMAdABhAHQA
// SIG // ZQBtAGUAbgB0AC4gHTANBgkqhkiG9w0BAQsFAAOCAgEA
// SIG // Z/KGpZjgVHkaLtPYdGcimwuWEeFjkplCln3SeQyQwWVf
// SIG // Liw++MNy0W2D/r4/6ArKO79HqaPzadtjvyI1pZddZYSQ
// SIG // fYtGUFXYDJJ80hpLHPM8QotS0LD9a+M+By4pm+Y9G6XU
// SIG // tR13lDni6WTJRD14eiPzE32mkHSDjfTLJgJGKsKKELuk
// SIG // qQUMm+1o+mgulaAqPyprWEljHwlpblqYluSD9MCP80Yr
// SIG // 3vw70L01724lruWvJ+3Q3fMOr5kol5hNDj0L8giJ1h/D
// SIG // Mhji8MUtzluetEk5CsYKwsatruWy2dsViFFFWDgycSca
// SIG // f7H0J/jeLDogaZiyWYlobm+nt3TDQAUGpgEqKD6CPxNN
// SIG // ZgvAs0314Y9/HG8VfUWnduVAKmWjw11SYobDHWM2l4bf
// SIG // 2vP48hahmifhzaWX0O5dY0HjWwechz4GdwbRBrF1HxS+
// SIG // YWG18NzGGwS+30HHDiju3mUv7Jf2oVyW2ADWoUa9WfOX
// SIG // pQlLSBCZgB/QACnFsZulP0V3HjXG0qKin3p6IvpIlR+r
// SIG // +0cjgPWe+L9rt0uX4ut1eBrs6jeZeRhL/9azI2h15q/6
// SIG // /IvrC4DqaTuv/DDtBEyO3991bWORPdGdVk5Pv4BXIqF4
// SIG // ETIheu9BCrE/+6jMpF3BoYibV3FWTkhFwELJm3ZbCoBI
// SIG // a/15n8G9bW1qyVJzEw16UM0xghoKMIIaBgIBATCBlTB+
// SIG // MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3Rv
// SIG // bjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWlj
// SIG // cm9zb2Z0IENvcnBvcmF0aW9uMSgwJgYDVQQDEx9NaWNy
// SIG // b3NvZnQgQ29kZSBTaWduaW5nIFBDQSAyMDExAhMzAAAE
// SIG // BGx0Bv9XKydyAAAAAAQEMA0GCWCGSAFlAwQCAQUAoIGu
// SIG // MBkGCSqGSIb3DQEJAzEMBgorBgEEAYI3AgEEMBwGCisG
// SIG // AQQBgjcCAQsxDjAMBgorBgEEAYI3AgEVMC8GCSqGSIb3
// SIG // DQEJBDEiBCCiXkwP+hDb3GC8ClBPp5hHfF7T5Hi/mZ9O
// SIG // 0XEEYOqRrTBCBgorBgEEAYI3AgEMMTQwMqAUgBIATQBp
// SIG // AGMAcgBvAHMAbwBmAHShGoAYaHR0cDovL3d3dy5taWNy
// SIG // b3NvZnQuY29tMA0GCSqGSIb3DQEBAQUABIIBACxTTX/6
// SIG // mSMVzBO1TCBjZJffW2Al1puU+SK8BrzLcN1p/jkV30gE
// SIG // CUEiYBR98BavYZkWXPOUE9Xnu7p11MS5Z0vXqGfP79w5
// SIG // TQOZqLMZ9aMBQvTYMMWCLhwFIWb2ZWh2tol1Ba4WoTgc
// SIG // N6Hxgb6Ssf7BMGyySc69GvCxeAoHJh1YccN4GmONeUGH
// SIG // jisx2DGiFXyswFQZuhCO3h/m+gbWSw7J+O7J8I+mktVk
// SIG // Lxz8UJOrAC07lAuR3dPpD2/HN4+cp3blLg2ff3tCbdQV
// SIG // BY9mHYeK6JL+SlDBA6WKOwPQLkRWeBsZQXrgIv2kajds
// SIG // gJ9UEiyDtp+t21MiEqQ9Exz2iDWhgheUMIIXkAYKKwYB
// SIG // BAGCNwMDATGCF4Awghd8BgkqhkiG9w0BBwKgghdtMIIX
// SIG // aQIBAzEPMA0GCWCGSAFlAwQCAQUAMIIBUgYLKoZIhvcN
// SIG // AQkQAQSgggFBBIIBPTCCATkCAQEGCisGAQQBhFkKAwEw
// SIG // MTANBglghkgBZQMEAgEFAAQgnMpt1prmF1QM8qMejvSV
// SIG // OQ+auQbbiErumosCFHss+IgCBmeuC226mhgTMjAyNTAy
// SIG // MjAxNTI4MzQuNjE1WjAEgAIB9KCB0aSBzjCByzELMAkG
// SIG // A1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAO
// SIG // BgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29m
// SIG // dCBDb3Jwb3JhdGlvbjElMCMGA1UECxMcTWljcm9zb2Z0
// SIG // IEFtZXJpY2EgT3BlcmF0aW9uczEnMCUGA1UECxMeblNo
// SIG // aWVsZCBUU1MgRVNOOjdGMDAtMDVFMC1EOTQ3MSUwIwYD
// SIG // VQQDExxNaWNyb3NvZnQgVGltZS1TdGFtcCBTZXJ2aWNl
// SIG // oIIR6jCCByAwggUIoAMCAQICEzMAAAHwKnwdWTvmH60A
// SIG // AQAAAfAwDQYJKoZIhvcNAQELBQAwfDELMAkGA1UEBhMC
// SIG // VVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcT
// SIG // B1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jw
// SIG // b3JhdGlvbjEmMCQGA1UEAxMdTWljcm9zb2Z0IFRpbWUt
// SIG // U3RhbXAgUENBIDIwMTAwHhcNMjMxMjA2MTg0NTUxWhcN
// SIG // MjUwMzA1MTg0NTUxWjCByzELMAkGA1UEBhMCVVMxEzAR
// SIG // BgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1v
// SIG // bmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlv
// SIG // bjElMCMGA1UECxMcTWljcm9zb2Z0IEFtZXJpY2EgT3Bl
// SIG // cmF0aW9uczEnMCUGA1UECxMeblNoaWVsZCBUU1MgRVNO
// SIG // OjdGMDAtMDVFMC1EOTQ3MSUwIwYDVQQDExxNaWNyb3Nv
// SIG // ZnQgVGltZS1TdGFtcCBTZXJ2aWNlMIICIjANBgkqhkiG
// SIG // 9w0BAQEFAAOCAg8AMIICCgKCAgEAtR4tU6M4dztHMxPM
// SIG // X0Z68ppSTQmhlqJpj8tHiDX/uBCa+63/LUs5YBPCJeGY
// SIG // +PE+X00zgIepyE0X9pSu/rqXJ2f8YNACqA2KQUDlqy/T
// SIG // mxUocpSB36/w0OD7EV/BkbSJ7ibDJMEoOt23weENlIpD
// SIG // BD/wrWR4vMVuV7QCqfeXLN5r1AjLyAAPNya/1MgAwAiV
// SIG // 1VOJmmIrHM1M+ydddXg9SqxvZkPiE4J0Uf19sUwzAs/o
// SIG // qPGWRRxsBGYPnN75j6fO5uDqjilsoXKjFLqT73jv4EAv
// SIG // Ub+LMyzRg2qHj3iuiFNCanBo16sW3BKEv7NYQoD3e1Me
// SIG // mFnlq1F2sW2/iaLIDms1IFBrNWqqZy489GCn1Kp/IuU2
// SIG // 5kdXahJUeEAPjmX3lYaU6J6zOLBPzJSdSS6UdhcACB1H
// SIG // jH6LVzUIsrWH0QVDiRxXiWBH5WYFZNF8f+JGQXc4BUDz
// SIG // ln1XdjaM15QtnqRrVI2pbgNqLDr0B2cxjqCk71lD1/fT
// SIG // LLBjmztMSR3dA8oD/yQFafm0RiamtruwKi5tvrQE9usi
// SIG // Ob3nHA5jWbIN7w4dR3KQiWvUKUVvzA92vgBdsoFdbEZx
// SIG // lVFRt1Tg19wYRk/EzFPxolMt4ewpVzsZmfsHgriDswpE
// SIG // w2yuTpQEvKkj6YKflxpTixD2jN9TIH+mE6aQGnj9KKYc
// SIG // d+OaIbcCAwEAAaOCAUkwggFFMB0GA1UdDgQWBBTQgrKn
// SIG // V0cvzJo2RlUwL8e2BVqbJTAfBgNVHSMEGDAWgBSfpxVd
// SIG // AF5iXYP05dJlpxtTNRnpcjBfBgNVHR8EWDBWMFSgUqBQ
// SIG // hk5odHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20vcGtpb3Bz
// SIG // L2NybC9NaWNyb3NvZnQlMjBUaW1lLVN0YW1wJTIwUENB
// SIG // JTIwMjAxMCgxKS5jcmwwbAYIKwYBBQUHAQEEYDBeMFwG
// SIG // CCsGAQUFBzAChlBodHRwOi8vd3d3Lm1pY3Jvc29mdC5j
// SIG // b20vcGtpb3BzL2NlcnRzL01pY3Jvc29mdCUyMFRpbWUt
// SIG // U3RhbXAlMjBQQ0ElMjAyMDEwKDEpLmNydDAMBgNVHRMB
// SIG // Af8EAjAAMBYGA1UdJQEB/wQMMAoGCCsGAQUFBwMIMA4G
// SIG // A1UdDwEB/wQEAwIHgDANBgkqhkiG9w0BAQsFAAOCAgEA
// SIG // OCL0m56+IxD4KOVuMY9//tHQhsLM/Ot0BmdpgfWeEsLR
// SIG // hizL8H7EVLNzSJTw/y7FgMXVWB5JQM8C08EOTPj0Xcvd
// SIG // gxn7chDhjB37rexqvC90VHL6769AC/zTbXxKWwBJAhc7
// SIG // HnsbWObN4c49619sL6AWZtsrYcHC3mZjIB0Apo2af9tH
// SIG // x1iYK4z2I7HukQybVE5b1LI6/vO/P7fr60BCKpZnmwnh
// SIG // IvlUFcXO8BdC7jE8P4AlnXKh6Ki+diaLcSs2PI2UkO3H
// SIG // DR4QuHhxhUaWinokkNBl7ZWxiGz+JFtTtyc5So38Butj
// SIG // Qkr35jNYjw/dF2IhZu//JoEdegJqnnw7H4wQlsH96oXi
// SIG // DH4Gc1qnhM/JWhZjPA3ZF47jgkBP9i9E8Ya41LXTJAE3
// SIG // 13WY2EZbHAQ8q/MxjJaaxQuy3Magl5YcYbXdgjPpqXE3
// SIG // PEQdg9xKK9FHaD9+kPa+F1glVf9ip9AF7b1sbyH8jhZu
// SIG // Wi5dHhM5IX7/15lJQXjghJUu43XXVqQZUIybhx1B4zlR
// SIG // l5ayU+1+IYnBdaNt8eVPo+6jygXHq8j9v9aMX5h3OrgV
// SIG // 5VwSrpFf0AmQVQIgTGCYZ5LWpFh6aPbiHkp2E+kMe8H9
// SIG // kWrmByBEfEi0Zm5TMzzrPiR0M674e8Urcd9dCzqftA2j
// SIG // l7PMY2b4aZ/lrmYo+UZmYowwggdxMIIFWaADAgECAhMz
// SIG // AAAAFcXna54Cm0mZAAAAAAAVMA0GCSqGSIb3DQEBCwUA
// SIG // MIGIMQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGlu
// SIG // Z3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMV
// SIG // TWljcm9zb2Z0IENvcnBvcmF0aW9uMTIwMAYDVQQDEylN
// SIG // aWNyb3NvZnQgUm9vdCBDZXJ0aWZpY2F0ZSBBdXRob3Jp
// SIG // dHkgMjAxMDAeFw0yMTA5MzAxODIyMjVaFw0zMDA5MzAx
// SIG // ODMyMjVaMHwxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpX
// SIG // YXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYD
// SIG // VQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xJjAkBgNV
// SIG // BAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1wIFBDQSAyMDEw
// SIG // MIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEA
// SIG // 5OGmTOe0ciELeaLL1yR5vQ7VgtP97pwHB9KpbE51yMo1
// SIG // V/YBf2xK4OK9uT4XYDP/XE/HZveVU3Fa4n5KWv64NmeF
// SIG // RiMMtY0Tz3cywBAY6GB9alKDRLemjkZrBxTzxXb1hlDc
// SIG // wUTIcVxRMTegCjhuje3XD9gmU3w5YQJ6xKr9cmmvHaus
// SIG // 9ja+NSZk2pg7uhp7M62AW36MEBydUv626GIl3GoPz130
// SIG // /o5Tz9bshVZN7928jaTjkY+yOSxRnOlwaQ3KNi1wjjHI
// SIG // NSi947SHJMPgyY9+tVSP3PoFVZhtaDuaRr3tpK56KTes
// SIG // y+uDRedGbsoy1cCGMFxPLOJiss254o2I5JasAUq7vnGp
// SIG // F1tnYN74kpEeHT39IM9zfUGaRnXNxF803RKJ1v2lIH1+
// SIG // /NmeRd+2ci/bfV+AutuqfjbsNkz2K26oElHovwUDo9Fz
// SIG // pk03dJQcNIIP8BDyt0cY7afomXw/TNuvXsLz1dhzPUNO
// SIG // wTM5TI4CvEJoLhDqhFFG4tG9ahhaYQFzymeiXtcodgLi
// SIG // Mxhy16cg8ML6EgrXY28MyTZki1ugpoMhXV8wdJGUlNi5
// SIG // UPkLiWHzNgY1GIRH29wb0f2y1BzFa/ZcUlFdEtsluq9Q
// SIG // BXpsxREdcu+N+VLEhReTwDwV2xo3xwgVGD94q0W29R6H
// SIG // XtqPnhZyacaue7e3PmriLq0CAwEAAaOCAd0wggHZMBIG
// SIG // CSsGAQQBgjcVAQQFAgMBAAEwIwYJKwYBBAGCNxUCBBYE
// SIG // FCqnUv5kxJq+gpE8RjUpzxD/LwTuMB0GA1UdDgQWBBSf
// SIG // pxVdAF5iXYP05dJlpxtTNRnpcjBcBgNVHSAEVTBTMFEG
// SIG // DCsGAQQBgjdMg30BATBBMD8GCCsGAQUFBwIBFjNodHRw
// SIG // Oi8vd3d3Lm1pY3Jvc29mdC5jb20vcGtpb3BzL0RvY3Mv
// SIG // UmVwb3NpdG9yeS5odG0wEwYDVR0lBAwwCgYIKwYBBQUH
// SIG // AwgwGQYJKwYBBAGCNxQCBAweCgBTAHUAYgBDAEEwCwYD
// SIG // VR0PBAQDAgGGMA8GA1UdEwEB/wQFMAMBAf8wHwYDVR0j
// SIG // BBgwFoAU1fZWy4/oolxiaNE9lJBb186aGMQwVgYDVR0f
// SIG // BE8wTTBLoEmgR4ZFaHR0cDovL2NybC5taWNyb3NvZnQu
// SIG // Y29tL3BraS9jcmwvcHJvZHVjdHMvTWljUm9vQ2VyQXV0
// SIG // XzIwMTAtMDYtMjMuY3JsMFoGCCsGAQUFBwEBBE4wTDBK
// SIG // BggrBgEFBQcwAoY+aHR0cDovL3d3dy5taWNyb3NvZnQu
// SIG // Y29tL3BraS9jZXJ0cy9NaWNSb29DZXJBdXRfMjAxMC0w
// SIG // Ni0yMy5jcnQwDQYJKoZIhvcNAQELBQADggIBAJ1Vffwq
// SIG // reEsH2cBMSRb4Z5yS/ypb+pcFLY+TkdkeLEGk5c9MTO1
// SIG // OdfCcTY/2mRsfNB1OW27DzHkwo/7bNGhlBgi7ulmZzpT
// SIG // Td2YurYeeNg2LpypglYAA7AFvonoaeC6Ce5732pvvinL
// SIG // btg/SHUB2RjebYIM9W0jVOR4U3UkV7ndn/OOPcbzaN9l
// SIG // 9qRWqveVtihVJ9AkvUCgvxm2EhIRXT0n4ECWOKz3+SmJ
// SIG // w7wXsFSFQrP8DJ6LGYnn8AtqgcKBGUIZUnWKNsIdw2Fz
// SIG // Lixre24/LAl4FOmRsqlb30mjdAy87JGA0j3mSj5mO0+7
// SIG // hvoyGtmW9I/2kQH2zsZ0/fZMcm8Qq3UwxTSwethQ/gpY
// SIG // 3UA8x1RtnWN0SCyxTkctwRQEcb9k+SS+c23Kjgm9swFX
// SIG // SVRk2XPXfx5bRAGOWhmRaw2fpCjcZxkoJLo4S5pu+yFU
// SIG // a2pFEUep8beuyOiJXk+d0tBMdrVXVAmxaQFEfnyhYWxz
// SIG // /gq77EFmPWn9y8FBSX5+k77L+DvktxW/tM4+pTFRhLy/
// SIG // AsGConsXHRWJjXD+57XQKBqJC4822rpM+Zv/Cuk0+CQ1
// SIG // ZyvgDbjmjJnW4SLq8CdCPSWU5nR0W2rRnj7tfqAxM328
// SIG // y+l7vzhwRNGQ8cirOoo6CGJ/2XBjU02N7oJtpQUQwXEG
// SIG // ahC0HVUzWLOhcGbyoYIDTTCCAjUCAQEwgfmhgdGkgc4w
// SIG // gcsxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5n
// SIG // dG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVN
// SIG // aWNyb3NvZnQgQ29ycG9yYXRpb24xJTAjBgNVBAsTHE1p
// SIG // Y3Jvc29mdCBBbWVyaWNhIE9wZXJhdGlvbnMxJzAlBgNV
// SIG // BAsTHm5TaGllbGQgVFNTIEVTTjo3RjAwLTA1RTAtRDk0
// SIG // NzElMCMGA1UEAxMcTWljcm9zb2Z0IFRpbWUtU3RhbXAg
// SIG // U2VydmljZaIjCgEBMAcGBSsOAwIaAxUAwigGSir+ZbHQ
// SIG // tsqDBimIkMu/af+ggYMwgYCkfjB8MQswCQYDVQQGEwJV
// SIG // UzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMH
// SIG // UmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBv
// SIG // cmF0aW9uMSYwJAYDVQQDEx1NaWNyb3NvZnQgVGltZS1T
// SIG // dGFtcCBQQ0EgMjAxMDANBgkqhkiG9w0BAQsFAAIFAOth
// SIG // w94wIhgPMjAyNTAyMjAxNTA4MTRaGA8yMDI1MDIyMTE1
// SIG // MDgxNFowdDA6BgorBgEEAYRZCgQBMSwwKjAKAgUA62HD
// SIG // 3gIBADAHAgEAAgIX3zAHAgEAAgISPjAKAgUA62MVXgIB
// SIG // ADA2BgorBgEEAYRZCgQCMSgwJjAMBgorBgEEAYRZCgMC
// SIG // oAowCAIBAAIDB6EgoQowCAIBAAIDAYagMA0GCSqGSIb3
// SIG // DQEBCwUAA4IBAQBTCwRZN+RQnPzfRg+SwFhXnr5AWd1c
// SIG // VHxADo35cG3C1mb197EFGcSfOb1+Nny36CQTIVq4R0YW
// SIG // md4BkwMvlAvgW5iHWo09TiVM65vL1PQsp0ik6DssIb5q
// SIG // np7urfjkYs4G9qYK5Q+5xbetXsdGNdERGXo3FSRO8cy0
// SIG // TjRanuVlVpxD35g7Was96kwEQche0jFhUKwYaGL+1a6m
// SIG // g/vjg5BrGRQC0dS1PdfXjYWn+jhCWJdjLikdGFZxrVdc
// SIG // uX1ZLKwpUzxG+iRa/7ZnV/XDd1BxUhLzPNJyfwmNwNRA
// SIG // fKGWaPJHHj8cjvy7ThUBeEidXvKfm+hG93fQ9bYu1lv4
// SIG // ECNiMYIEDTCCBAkCAQEwgZMwfDELMAkGA1UEBhMCVVMx
// SIG // EzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1Jl
// SIG // ZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3Jh
// SIG // dGlvbjEmMCQGA1UEAxMdTWljcm9zb2Z0IFRpbWUtU3Rh
// SIG // bXAgUENBIDIwMTACEzMAAAHwKnwdWTvmH60AAQAAAfAw
// SIG // DQYJYIZIAWUDBAIBBQCgggFKMBoGCSqGSIb3DQEJAzEN
// SIG // BgsqhkiG9w0BCRABBDAvBgkqhkiG9w0BCQQxIgQgcQtH
// SIG // 5t+kTN3Jo+zG+6BFN5AB+zZKw/OUqdMPSHwOJ78wgfoG
// SIG // CyqGSIb3DQEJEAIvMYHqMIHnMIHkMIG9BCBcAZqjpXL9
// SIG // 5FO5gAebFke+EBQIkupm/gjOmrJxQGVLizCBmDCBgKR+
// SIG // MHwxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5n
// SIG // dG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVN
// SIG // aWNyb3NvZnQgQ29ycG9yYXRpb24xJjAkBgNVBAMTHU1p
// SIG // Y3Jvc29mdCBUaW1lLVN0YW1wIFBDQSAyMDEwAhMzAAAB
// SIG // 8Cp8HVk75h+tAAEAAAHwMCIEICfu7D/aEYVtoD42f8pa
// SIG // W2rfdnAyYN5qaKGMxqC6AkyoMA0GCSqGSIb3DQEBCwUA
// SIG // BIICAB3aRXsjD6huPOmokXdGG0f78elh/+y4YGQsyp2o
// SIG // hCFlPKCJsuSUSyp9gqxVeFqSxE/T/Oo8CAlExkWI759p
// SIG // /2tp5qvmnsl1UXSUjsmM+c8Cf38nZ5+nXE4y4rxcGQ0q
// SIG // D0OPy6o/bcChHUYOtnDcDimrRAxqqPMZN3WtRjQ6Bmto
// SIG // wEkX79A3MhM6tB/r13hk1XSYZtX0Dg0z0zOivQkdhz9q
// SIG // 3RSDCGh7h06ehZBIVC57JVLWl6vkbcWdZuHvb1WoUgwu
// SIG // Ya2AD+uI9etVxzthB2BjYpcTwD2KRibnTEbUgpFDRXsn
// SIG // TI0iTYTh/Fgfxbqzoh4XBL2QLegPearnnmTxRDilfXfE
// SIG // t1qHv3Q4Ub1Gsg2uFCOAromUA9l/u7SNyCEx+xJ380mR
// SIG // a2UZACapIQm9Yngoo4j97xrt0j3DTC/sOz2zhmLhdzIT
// SIG // CZ2nF3tr5IpDWo3VGSL13tA+uz8MDvAYbaNaXEna0BgD
// SIG // p2lnB/XcBlcZuIr3qKf9p11tZ33PN535U+G/al9ivXoc
// SIG // Tk3Us5n/X8V30FdJSQjqk5nE1vSKEPqf9Vu0poCjmJY1
// SIG // +FoqGJhn8t7vACJv8t8aX85xcULA3BgL0jEdj0hp/vzx
// SIG // psStJt6Zfsx2+0NBrvyqvlXOaQ4GarHsiTU9H8FAImqN
// SIG // H9oW0Tr9VEZy2UPiOmHsxB237+eu
// SIG // End signature block