PowerShellでSentinelOneエンドポイントを管理しセキュリティリスクを低減する方法

# SentinelOne API URLと認証トークン
$ApiUrl = "https://<SentinelOne管理URL>/web/api/v2.1/agents"
$ApiToken = "<取得したAPIトークン>"

# ヘッダー情報の設定
$Headers = @{
    "Authorization" = "ApiToken $ApiToken"
    "Content-Type"  = "application/json"
}

# エンドポイント一覧を取得するリクエスト
$response = Invoke-RestMethod -Uri $ApiUrl -Method Get -Headers $Headers

# 結果を表示
$response.data

# API URLと認証トークン
$ApiUrl = "https://<SentinelOne管理URL>/web/api/v2.1/agents"
$ApiToken = "<取得したAPIトークン>"

# ヘッダー情報
$Headers = @{
    "Authorization" = "ApiToken $ApiToken"
    "Content-Type"  = "application/json"
}

# エンドポイント一覧を取得
$response = Invoke-RestMethod -Uri $ApiUrl -Method Get -Headers $Headers

# エンドポイントのステータスを表示
foreach ($agent in $response.data) {
    Write-Output "エンドポイント名: $($agent.hostname)"
    Write-Output "ステータス: $($agent.status)"
    Write-Output "IPアドレス: $($agent.networkInterfaces[0].inet)"
    Write-Output "-----------------------------------"
}

# API URLとエンドポイントID
$ApiUrl = "https://<SentinelOne管理URL>/web/api/v2.1/agents/<エンドポイントID>/isolate"
$ApiToken = "<取得したAPIトークン>"

# ヘッダー情報
$Headers = @{
    "Authorization" = "ApiToken $ApiToken"
    "Content-Type"  = "application/json"
}

# エンドポイントを隔離
$response = Invoke-RestMethod -Uri $ApiUrl -Method Post -Headers $Headers

# 結果の確認
if ($response.success) {
    Write-Output "エンドポイントを正常に隔離しました。"
} else {
    Write-Output "隔離に失敗しました。エラー: $($response.errors)"
}

# API URLとエンドポイントID
$ApiUrl = "https://<SentinelOne管理URL>/web/api/v2.1/agents/<エンドポイントID>/unisolate"
$ApiToken = "<取得したAPIトークン>"

# ヘッダー情報
$Headers = @{
    "Authorization" = "ApiToken $ApiToken"
    "Content-Type"  = "application/json"
}

# 隔離解除
$response = Invoke-RestMethod -Uri $ApiUrl -Method Post -Headers $Headers

# 結果の確認
if ($response.success) {
    Write-Output "エンドポイントを正常に再接続しました。"
} else {
    Write-Output "再接続に失敗しました。エラー: $($response.errors)"
}

# スケジュールタスクの作成例
$Action = New-ScheduledTaskAction -Execute "PowerShell.exe" -Argument "-File 'C:\Scripts\MonitorEndpoints.ps1'"
$Trigger = New-ScheduledTaskTrigger -Daily -At 08:00AM
Register-ScheduledTask -Action $Action -Trigger $Trigger -TaskName "SentinelOneMonitor" -Description "SentinelOneエンドポイント監視スクリプト"

# ログファイルの保存
$LogFilePath = "C:\Logs\SentinelOneEndpoints.log"
$response.data | Out-File -FilePath $LogFilePath -Encoding UTF8
Write-Output "エンドポイント情報をログに保存しました: $LogFilePath"

# API URL
$ApiUrl = "https://<SentinelOne管理URL>/web/api/v2.1/agents"
$ApiToken = "<取得したAPIトークン>"

# 登録するエンドポイント情報
$NewAgent = @{
    hostname = "NewEndpoint01"
    groupId  = "<ターゲットグループID>"
} | ConvertTo-Json -Depth 10

# ヘッダー情報
$Headers = @{
    "Authorization" = "ApiToken $ApiToken"
    "Content-Type"  = "application/json"
}

# エンドポイント登録リクエスト
$response = Invoke-RestMethod -Uri $ApiUrl -Method Post -Headers $Headers -Body $NewAgent

# 結果の表示
if ($response.success) {
    Write-Output "新しいエンドポイントを正常に登録しました: $($response.data.hostname)"
} else {
    Write-Output "登録に失敗しました。エラー: $($response.errors)"
}

# スキャンAPIのURLと対象エンドポイントID
$ApiUrl = "https://<SentinelOne管理URL>/web/api/v2.1/agents/<エンドポイントID>/threats/scan"
$ApiToken = "<取得したAPIトークン>"

# ヘッダー情報
$Headers = @{
    "Authorization" = "ApiToken $ApiToken"
    "Content-Type"  = "application/json"
}

# スキャン実行リクエスト
$response = Invoke-RestMethod -Uri $ApiUrl -Method Post -Headers $Headers

# 結果の表示
if ($response.success) {
    Write-Output "エンドポイントで脅威スキャンを開始しました。"
} else {
    Write-Output "スキャン開始に失敗しました。エラー: $($response.errors)"
}

# 脅威の解決API URL
$ApiUrl = "https://<SentinelOne管理URL>/web/api/v2.1/threats/<脅威ID>/resolve"
$ApiToken = "<取得したAPIトークン>"

# ヘッダー情報
$Headers = @{
    "Authorization" = "ApiToken $ApiToken"
    "Content-Type"  = "application/json"
}

# 脅威解決リクエスト
$response = Invoke-RestMethod -Uri $ApiUrl -Method Post -Headers $Headers

# 結果の表示
if ($response.success) {
    Write-Output "脅威を正常に解決しました。"
} else {
    Write-Output "脅威の解決に失敗しました。エラー: $($response.errors)"
}

# レポート生成
$ApiUrl = "https://<SentinelOne管理URL>/web/api/v2.1/agents"
$ApiToken = "<取得したAPIトークン>"
$Headers = @{
    "Authorization" = "ApiToken $ApiToken"
    "Content-Type"  = "application/json"
}

# エンドポイント情報を取得
$response = Invoke-RestMethod -Uri $ApiUrl -Method Get -Headers $Headers

# レポートファイルのパス
$ReportPath = "C:\Reports\EndpointReport_$(Get-Date -Format 'yyyyMMdd').csv"

# CSVとして保存
$response.data | Export-Csv -Path $ReportPath -NoTypeInformation -Encoding UTF8
Write-Output "エンドポイントレポートを生成しました: $ReportPath"

# メール送信
Send-MailMessage -To "admin@example.com" -From "reporting@example.com" -Subject "SentinelOne エンドポイントレポート" -Body "レポートを添付しました。" -Attachments $ReportPath -SmtpServer "smtp.example.com"

# スケジュールタスク作成例
$Action = New-ScheduledTaskAction -Execute "PowerShell.exe" -Argument "-File 'C:\Scripts\AutomatedTasks.ps1'"
$Trigger = New-ScheduledTaskTrigger -Daily -At 02:00AM
Register-ScheduledTask -Action $Action -Trigger $Trigger -TaskName "SentinelOneTasks" -Description "SentinelOne管理タスクの自動化"

$ApiToken = "<新しいAPIトークン>"
$ApiUrl = "https://<正しいURL>/web/api/v2.1/agents"

# 正しいJSON形式のリクエストボディ
$RequestBody = @{
    groupId = "<GroupID>"
    hostname = "NewEndpoint"
} | ConvertTo-Json -Depth 10

[System.Net.WebRequest]::DefaultWebProxy.Credentials = [System.Net.CredentialCache]::DefaultNetworkCredentials

# 特定グループに絞って取得
$ApiUrl = "https://<SentinelOne管理URL>/web/api/v2.1/agents?groupId=<GroupID>"

try {
    $response = Invoke-RestMethod -Uri $ApiUrl -Method Get -Headers $Headers
} catch {
    # エラー内容をログファイルに記録
    $_ | Out-File -FilePath "C:\Logs\SentinelOneErrors.log" -Append
    Write-Output "エラーが発生しました。ログに記録しました。"
}

# 暗号化して保存
$ApiToken = "YourAPIToken"
$SecureToken = ConvertTo-SecureString -String $ApiToken -AsPlainText -Force
$SecureToken | Export-Clixml -Path "C:\Secure\ApiToken.xml"

# 復号化して利用
$SecureToken = Import-Clixml -Path "C:\Secure\ApiToken.xml"
$PlainToken = [System.Runtime.InteropServices.Marshal]::PtrToStringAuto([System.Runtime.InteropServices.Marshal]::SecureStringToBSTR($SecureToken))

# 異常イベントの検出
if ($response.data.status -ne "Healthy") {
    Send-MailMessage -To "admin@example.com" -From "monitor@example.com" -Subject "エンドポイント異常検知" -Body "エンドポイントに異常が発生しました。" -SmtpServer "smtp.example.com"
}

# 管理者承認プロンプト
$Confirmation = Read-Host "エンドポイントを隔離しますか？(Yes/No)"
if ($Confirmation -eq "Yes") {
    # 隔離処理を実行
    Invoke-RestMethod -Uri $ApiUrl -Method Post -Headers $Headers
} else {
    Write-Output "操作をキャンセルしました。"
}

# 特定グループのエンドポイント取得
$GroupId = "<GroupID>"
$ApiUrl = "https://<SentinelOne管理URL>/web/api/v2.1/agents?groupId=$GroupId"
$response = Invoke-RestMethod -Uri $ApiUrl -Method Get -Headers $Headers

foreach ($agent in $response.data) {
    Write-Output "エンドポイント名: $($agent.hostname)"
}