API မှတစ်ဆင့် PowerShell မှ Google အသုံးပြုသူများကို ဖန်တီးခြင်း။

မေတ္တာနှင့်ကြားလိုက်ပါ၏!

G Suite အသုံးပြုသူများကို ကိုင်တွယ်ရန် Google API နှင့် PowerShell အပြန်အလှန်တုံ့ပြန်မှုကို ဤဆောင်းပါးတွင် ဖော်ပြပါမည်။

ကျွန်ုပ်တို့သည် အဖွဲ့အစည်းအနှံ့ရှိ ဌာနတွင်းနှင့် cloud ဝန်ဆောင်မှုများစွာကို အသုံးပြုပါသည်။ အများစုအတွက်၊ ၎င်းတို့တွင် ခွင့်ပြုချက်သည် ပုံတူကို မထိန်းသိမ်းနိုင်သည့်ကြားတွင် Google သို့မဟုတ် Active Directory ထံ ဆင်းသက်လာသည်၊ ထို့ကြောင့် ဝန်ထမ်းအသစ်မှ ထွက်သွားသည့်အခါ၊ သင်သည် ဤစနစ်နှစ်ခုတွင် အကောင့်တစ်ခု ဖန်တီး/ဖွင့်ရန် လိုအပ်ပါသည်။ လုပ်ငန်းစဉ်ကို အလိုအလျောက်လုပ်ဆောင်ရန် ကျွန်ုပ်တို့သည် အချက်အလက်များကို စုဆောင်းပြီး ဝန်ဆောင်မှုနှစ်ခုလုံးထံ ပေးပို့သည့် ဇာတ်ညွှန်းတစ်ခုကို ရေးသားရန် ဆုံးဖြတ်ခဲ့သည်။

အခွင့်အာဏာပေးခြင်း

လိုအပ်ချက်များကို ရေးဆွဲသည့်အခါ၊ ခွင့်ပြုချက်အတွက် စစ်မှန်သော လူသားစီမံခန့်ခွဲသူများကို အသုံးပြုရန် ဆုံးဖြတ်ခဲ့သည်၊ ၎င်းသည် မတော်တဆ သို့မဟုတ် ရည်ရွယ်ချက်ရှိရှိ ကြီးမားသော အပြောင်းအလဲများဖြစ်ပေါ်သည့်အခါ လုပ်ဆောင်ချက်များကို ခွဲခြမ်းစိတ်ဖြာခြင်းအား ရိုးရှင်းစေသည်။

Google API များသည် စစ်မှန်ကြောင်းနှင့် ခွင့်ပြုချက်အတွက် OAuth 2.0 ပရိုတိုကောကို အသုံးပြုသည်။ အသုံးပြုမှုကိစ္စများနှင့် အသေးစိတ်ဖော်ပြချက်များကို ဤနေရာတွင် တွေ့နိုင်သည်- Google API များကိုဝင်ရောက်အသုံးပြုရန် OAuth 2.0 ကိုအသုံးပြုခြင်း။.

desktop အပလီကေးရှင်းများတွင် ခွင့်ပြုချက်အတွက်အသုံးပြုသော script ကို ငါရွေးချယ်ခဲ့သည်။ အသုံးပြုသူထံမှမလိုအပ်သောလှုပ်ရှားမှုများမလိုအပ်သောဝန်ဆောင်မှုအကောင့်ကိုအသုံးပြုရန်ရွေးချယ်ခွင့်လည်းရှိသည်။

အောက်ဖော်ပြပါပုံသည် Google စာမျက်နှာမှ ရွေးချယ်ထားသော ဇာတ်လမ်းပုံစံ၏ သရုပ်ဖော်ပုံဖြစ်သည်။

1. ပထမဦးစွာ၊ ကျွန်ုပ်တို့သည် အသုံးပြုသူကို GET ဘောင်များကို သတ်မှတ်ပေးခြင်းဖြင့် Google အကောင့် အထောက်အထားစိစစ်ခြင်းစာမျက်နှာသို့ ပေးပို့သည်-
   • လျှောက်လွှာ ID
   • အပလီကေးရှင်းသို့ဝင်ရောက်ရန် လိုအပ်သည့်နေရာများ
   • လုပ်ထုံးလုပ်နည်းကို ပြီးမြောက်ပြီးနောက် အသုံးပြုသူကို ပြန်ညွှန်းမည့်လိပ်စာ
   • တိုကင်ကို အပ်ဒိတ်လုပ်နည်း
   • လုံခြုံရေးကုဒ်နံပါတ်
   • အတည်ပြုကုဒ် ထုတ်လွှင့်မှုပုံစံ

2. ခွင့်ပြုချက်ပြီးစီးပြီးနောက်၊ အသုံးပြုသူအား ပထမတောင်းဆိုချက်တွင် သတ်မှတ်ထားသည့် စာမျက်နှာသို့ အမှားအယွင်းတစ်ခု သို့မဟုတ် ခွင့်ပြုချက်ကုဒ်ကို GET ဘောင်များမှတစ်ဆင့် ကျော်ဖြတ်သွားမည်ဖြစ်သည်။
3. အပလီကေးရှင်း (script) သည် အဆိုပါ ကန့်သတ်ချက်များကို လက်ခံရရှိရန် လိုအပ်မည်ဖြစ်ပြီး၊ ကုဒ်ကို လက်ခံရရှိပါက တိုကင်များရယူရန် အောက်ပါတောင်းဆိုချက်ကို ပြုလုပ်ပါ။
4. တောင်းဆိုချက်မှန်ကန်ပါက၊ Google API မှ ပြန်ပို့သည်-
   • ကျွန်ုပ်တို့ တောင်းဆိုမှုများ ပြုလုပ်နိုင်သည့် တိုကင်ကို အသုံးပြုခွင့်
   • ဤတိုကင်၏တရားဝင်ကာလ
   • Access token ကို ပြန်လည်စတင်ရန် တိုကင်ကို ပြန်လည်စတင်ရန် လိုအပ်သည်။

ပထမဦးစွာ သင်သည် Google API ကွန်ဆိုးလ်သို့ သွားရန်လိုအပ်သည်- အထောက်အထားများ - Google API Console၊ အလိုရှိသော အပလီကေးရှင်းကို ရွေးချယ်ပြီး အထောက်အထားများ ကဏ္ဍတွင် သုံးစွဲသူ OAuth အထောက်အထားကို ဖန်တီးပါ။ ထိုနေရာတွင် (သို့မဟုတ် နောက်ပိုင်းတွင်၊ ဖန်တီးထားသော သတ်မှတ်သူ၏ ဂုဏ်သတ္တိများ) ​​သို့ ပြန်ညွှန်းခြင်းအား ခွင့်ပြုထားသည့် လိပ်စာများကို သတ်မှတ်ရန် လိုအပ်သည်။ ကျွန်ုပ်တို့၏အခြေအနေတွင်၊ ၎င်းတို့သည် မတူညီသော port များပါရှိသော localhost entries များဖြစ်လိမ့်မည် (အောက်တွင်ကြည့်ပါ)။

script algorithm ကိုဖတ်ရန် ပိုမိုအဆင်ပြေစေရန်၊ သင်သည် အပလီကေးရှင်းအတွက် Access and refresh tokens ကို ပြန်ပေးမည့် သီးခြားလုပ်ဆောင်မှုတစ်ခုတွင် ပထမအဆင့်များကို သင်ပြသနိုင်သည်-

$client_secret = 'Our Client Secret'
$client_id = 'Our Client ID'
function Get-GoogleAuthToken {
  if (-not [System.Net.HttpListener]::IsSupported) {
    "HttpListener is not supported."
    exit 1
  }
  $codeverifier = -join ((65..90) + (97..122) + (48..57) + 45 + 46 + 95 + 126 |Get-Random -Count 60| % {[char]$_})
  $hasher = new-object System.Security.Cryptography.SHA256Managed
  $hashByteArray = $hasher.ComputeHash([System.Text.Encoding]::UTF8.GetBytes($codeverifier))
  $base64 = ((([System.Convert]::ToBase64String($hashByteArray)).replace('=','')).replace('+','-')).replace('/','_')
  $ports = @(10600,15084,39700,42847,65387,32079)
  $port = $ports[(get-random -Minimum 0 -maximum 5)]
  Write-Host "Start browser..."
  Start-Process "https://accounts.google.com/o/oauth2/v2/auth?code_challenge_method=S256&code_challenge=$base64&access_type=offline&client_id=$client_id&redirect_uri=http://localhost:$port&response_type=code&scope=https://www.googleapis.com/auth/admin.directory.user https://www.googleapis.com/auth/admin.directory.group"
  $listener = New-Object System.Net.HttpListener
  $listener.Prefixes.Add("http://localhost:"+$port+'/')
  try {$listener.Start()} catch {
    "Unable to start listener."
    exit 1
  }
  while (($code -eq $null)) {
    $context = $listener.GetContext()
    Write-Host "Connection accepted" -f 'mag'
    $url = $context.Request.RawUrl
    $code = $url.split('?')[1].split('=')[1].split('&')[0]
    if ($url.split('?')[1].split('=')[0] -eq 'error') {
      Write-Host "Error!"$code -f 'red'
      $buffer = [System.Text.Encoding]::UTF8.GetBytes("Error!"+$code)
      $context.Response.ContentLength64 = $buffer.Length
      $context.Response.OutputStream.Write($buffer, 0, $buffer.Length)
      $context.Response.OutputStream.Close()
      $listener.Stop()
      exit 1
    }
    $buffer = [System.Text.Encoding]::UTF8.GetBytes("Now you can close this browser tab.")
    $context.Response.ContentLength64 = $buffer.Length
    $context.Response.OutputStream.Write($buffer, 0, $buffer.Length)
    $context.Response.OutputStream.Close()
    $listener.Stop()
  }
  Return Invoke-RestMethod -Method Post -Uri "https://www.googleapis.com/oauth2/v4/token" -Body @{
    code = $code
    client_id = $client_id
    client_secret = $client_secret
    redirect_uri = 'http://localhost:'+$port
    grant_type = 'authorization_code'
    code_verifier   = $codeverifier
  }
  $code = $null

ကျွန်ုပ်တို့သည် OAuth ကလိုင်းယင့်သတ်မှတ်မှုဆိုင်ရာ ဂုဏ်သတ္တိများတွင်ရရှိသော ဖောက်သည် ID နှင့် ဖောက်သည်လျှို့ဝှက်ချက်ကို သတ်မှတ်ခဲ့ပြီး၊ ကုဒ်အတည်ပြုသူသည် သီးသန့်မထားသောအက္ခရာများမှ ကျပန်းထုတ်ပေးရမည်ဖြစ်ပြီး စာလုံးရေ 43 မှ 128 လုံးပါရှိသည်- [AZ] / [az] / [0-9] /"-"/"။ /"_"/"~"။

ထို့နောက် ဤကုဒ်ကို ထပ်မံပေးပို့ပါမည်။ ၎င်းသည် အသုံးပြုသူခွင့်ပြုချက်ပြီးနောက် ပြန်လည်လမ်းညွှန်မှုအဖြစ် တိုက်ခိုက်သူမှ ပြန်လာသောတုံ့ပြန်မှုကို ကြားဖြတ်ဟန့်တားနိုင်သည့် အားနည်းချက်ကို ဖယ်ရှားပေးသည်။
သင်သည် လက်ရှိတောင်းဆိုမှုတွင် ကုဒ်အတည်ပြုသူအား ရှင်းလင်းသောစာသားဖြင့် ပေးပို့နိုင်သည် (၎င်းသည် အဓိပ္ပါယ်မဲ့စေသည် - ၎င်းသည် SHA256 ကိုမပံ့ပိုးသောစနစ်များအတွက်သာသင့်လျော်သည်) သို့မဟုတ် BASE256Url တွင် ကုဒ်လုပ်ထားရမည်ဖြစ်ပြီး BASE64Url (ကွဲပြားသည် Base64 မှ ဇယားအက္ခရာ နှစ်ခုဖြင့်) နှင့် ဇာတ်ကောင်မျဉ်းအဆုံးသတ်များကို ဖယ်ရှားခြင်း- =။

ဆက်လက်၍၊ ခွင့်ပြုချက်ပြီးနောက် တုံ့ပြန်ချက်တစ်ခုရရှိရန်အတွက်၊ ပြန်လည်လမ်းညွှန်မှုတစ်ခုအဖြစ် ပြန်ပေးမည့် တုံ့ပြန်ချက်ကိုရရှိရန်အတွက် ပြည်တွင်းစက်တွင် http ကို စတင်နားထောင်ရန် လိုအပ်သည်။

စီမံခန့်ခွဲရေးဆိုင်ရာတာဝန်များကို အထူးဆာဗာတစ်ခုပေါ်တွင် လုပ်ဆောင်သည်၊ စီမံခန့်ခွဲသူအများအပြားသည် တစ်ချိန်တည်းတွင် script ကို run မည့်ဖြစ်နိုင်ခြေကို ကျွန်ုပ်တို့မငြင်းနိုင်သောကြောင့် လက်ရှိအသုံးပြုသူအတွက် port တစ်ခုကို ကျပန်းရွေးချယ်ပေးမည်ဖြစ်သော်လည်း ကြိုတင်သတ်မှတ်ထားသော port များကို ကျွန်ုပ်သတ်မှတ်ထားသောကြောင့်၊ ၎င်းတို့ကို API ကွန်ဆိုးလ်တွင် ယုံကြည်ထားသည့်အတိုင်း ပေါင်းထည့်ရပါမည်။

access_type=အော့ဖ်လိုင်း ဆိုလိုသည်မှာ အပလီကေးရှင်းသည် ဘရောက်ဆာနှင့် အသုံးပြုသူ အပြန်အလှန်ဆက်သွယ်မှုမရှိဘဲ သက်တမ်းကုန်ဆုံးသွားသော တိုကင်တစ်ခုကို ၎င်း၏ကိုယ်ပိုင် update လုပ်နိုင်သည်၊
response_type=ကုဒ် ကုဒ်ကို မည်သို့ပြန်ပေးမည်ကို ပုံစံသတ်မှတ်သည် (အသုံးပြုသူသည် ဘရောက်ဆာမှ ကုဒ်ကို script ထဲသို့ ကူးယူသောအခါ၊ ခွင့်ပြုချက်နည်းလမ်းဟောင်းကို ရည်ညွှန်းသည်)၊
နယ်ပယ် အတိုင်းအတာနှင့် ဝင်ရောက်မှု အမျိုးအစားကို ညွှန်ပြသည်။ ၎င်းတို့ကို နေရာလွတ်များ သို့မဟုတ် %20 (URL ကုဒ်သွင်းခြင်းအရ) ခြားထားရပါမည်။ အမျိုးအစားများပါရှိသော အသုံးပြုခွင့်ဧရိယာများစာရင်းကို ဤနေရာတွင် ကြည့်ရှုနိုင်သည်- Google APIs အတွက် OAuth 2.0 နယ်ပယ်များ.

ခွင့်ပြုချက်ကုဒ်ကို လက်ခံရရှိပြီးနောက်၊ အပလီကေးရှင်းသည် ဘရောက်ဆာထံ အနီးကပ်မက်ဆေ့ချ်ကို ပြန်ပေးမည်ဖြစ်ပြီး၊ ဆိပ်ကမ်းတွင် နားထောင်ခြင်းကို ရပ်တန့်ကာ တိုကင်ရယူရန် POST တောင်းဆိုချက်ကို ပေးပို့မည်ဖြစ်သည်။ ကျွန်ုပ်တို့သည် ၎င်းတွင် ယခင်က သတ်မှတ်ထားသော အိုင်ဒီနှင့် ကွန်ဆိုးလ် API မှ လျှို့ဝှက်ချက်၊ အသုံးပြုသူကို ပြန်လည်ညွှန်းပေးမည့် လိပ်စာနှင့် ပရိုတိုကော သတ်မှတ်ချက်နှင့်အညီ ခွင့်ပြုပေးမည့် အမျိုးအစား။

တုံ့ပြန်မှုအနေဖြင့်၊ ကျွန်ုပ်တို့သည် Access token ကို စက္ကန့်ပိုင်းအတွင်း ၎င်း၏တရားဝင်ကာလနှင့် ပြန်လည်စတင်ရန် တိုကင်တစ်ခုကို ကျွန်ုပ်တို့ရရှိမည်ဖြစ်ပြီး၊ Access token ကို အပ်ဒိတ်လုပ်နိုင်ပါသည်။

အပလီကေးရှင်းသည် တိုကင်များကို တာရှည်ခံသည့်နေရာတွင် လုံခြုံသောနေရာတွင် သိမ်းဆည်းထားရမည်ဖြစ်ပြီး၊ ထို့ကြောင့် ကျွန်ုပ်တို့ လက်ခံရရှိထားသော အသုံးပြုခွင့်ကို ရုပ်သိမ်းသည်အထိ အပလီကေးရှင်းမှ ပြန်လည်ဆန်းသစ်ထားသော တိုကင်ကို ပြန်ပေးမည်မဟုတ်ပါ။ အဆုံးတွင်၊ ကျွန်ုပ်သည် တိုကင်ကို ပြန်လည်ရုပ်သိမ်းရန် တောင်းဆိုချက်တစ်ခုကို ထည့်သွင်းခဲ့သည်၊ လျှောက်လွှာကို အောင်မြင်စွာ မပြီးမြောက်ခဲ့ဘဲ ပြန်လည်ဆန်းသစ်သည့် တိုကင်ကို ပြန်မရနိုင်ပါက၊ ၎င်းသည် လုပ်ငန်းစဉ်ကို ပြန်လည်စတင်လိမ့်မည် (ကျွန်ုပ်တို့သည် တိုကင်များကို စက်တွင်းတွင် သိုလှောင်ရန် အန္တရာယ်မရှိဟု ကျွန်ုပ်တို့ ယူဆကြပြီး၊ cryptography နဲ့ အရာတွေကို မရှုပ်ထွေးစေချင်ဘူး ဒါမှမဟုတ် ဘရောက်ဆာကို မကြာခဏဖွင့်ပါ။)

do {
  $token_result = Get-GoogleAuthToken
  $token = $token_result.access_token
  if ($token_result.refresh_token -eq $null) {
    Write-Host ("Session is not destroyed. Revoking token...")
    Invoke-WebRequest -Uri ("https://accounts.google.com/o/oauth2/revoke?token="+$token)
  }
} while ($token_result.refresh_token -eq $null)
$refresh_token = $token_result.refresh_token
$minute = ([int]("{0:mm}" -f ([timespan]::fromseconds($token_result.expires_in))))+((Get-date).Minute)-2
if ($minute -lt 0) {$minute += 60}
elseif ($minute -gt 59) {$minute -=60}
$token_expire = @{
  hour = ([int]("{0:hh}" -f ([timespan]::fromseconds($token_result.expires_in))))+((Get-date).Hour)
  minute = $minute
}

သင်သတိပြုမိထားသည့်အတိုင်း၊ တိုကင်တစ်ခုကို ရုပ်သိမ်းသည့်အခါ၊ Invoke-WebRequest ကို အသုံးပြုသည်။ Invoke-RestMethod နှင့်မတူဘဲ၊ ၎င်းသည် လက်ခံရရှိထားသောဒေတာကို အသုံးပြုနိုင်သောပုံစံဖြင့် ပြန်မပေးဘဲ တောင်းဆိုချက်၏အခြေအနေကိုပြသသည်။

ထို့နောက်၊ script သည် သင့်အား အသုံးပြုသူ၏ အမည်နှင့် နောက်ဆုံးအမည်ကို ရိုက်ထည့်ကာ လော့ဂ်အင် + အီးမေးလ်ကို ဖန်တီးခိုင်းသည်။

တောင်းဆိုချက်များ

နောက်တောင်းဆိုမှုများမှာ - ပထမဦးစွာ၊ အသစ်တစ်ခုဖန်တီးခြင်း သို့မဟုတ် လက်ရှိကိုဖွင့်ခြင်းဆိုင်ရာ ဆုံးဖြတ်ချက်တစ်ခုရရှိရန်အတွက် တူညီသော login ရှိသည့်အသုံးပြုသူရှိနှင့်ပြီးသားရှိမရှိ စစ်ဆေးရန် လိုအပ်ပါသည်။

ခလုတ်ကို အသုံးပြု၍ ရွေးချယ်မှုတစ်ခုဖြင့် လုပ်ဆောင်ချက်တစ်ခု၏ ဖော်မတ်တွင် တောင်းဆိုမှုအားလုံးကို အကောင်အထည်ဖော်ရန် ဆုံးဖြတ်ခဲ့သည်-

function GoogleQuery {
  param (
    $type,
    $query
  )
  switch ($type) {
    "SearchAccount" {
      Return Invoke-RestMethod -Method Get -Uri "https://www.googleapis.com/admin/directory/v1/users" -Headers @{Authorization = "Bearer "+(Get-GoogleToken)} -Body @{
        domain = 'rocketguys.com'
        query  = "email:$query"
      }
    }
    "UpdateAccount" {
      $body = @{
        name  = @{
          givenName = $query['givenName']
          familyName = $query['familyName']
        }
        suspended = 'false'
        password = $query['password']
        changePasswordAtNextLogin = 'true'
        phones = @(@{
          primary = 'true'
          value = $query['phone']
          type = "mobile"
        })
        orgUnitPath = $query['orgunit']
      }
      Return Invoke-RestMethod -Method Put -Uri ("https://www.googleapis.com/admin/directory/v1/users/"+$query['email']) -Headers @{Authorization = "Bearer "+(Get-GoogleToken)} -Body (ConvertTo-Json $body) -ContentType 'application/json; charset=utf-8'
    }
    
    "CreateAccount" {
      $body = @{
        primaryEmail = $query['email']
        name  = @{
          givenName = $query['givenName']
          familyName = $query['familyName']
        }
        suspended = 'false'
        password = $query['password']
        changePasswordAtNextLogin = 'true'
        phones = @(@{
          primary = 'true'
          value = $query['phone']
          type = "mobile"
        })
        orgUnitPath = $query['orgunit']
      }
      Return Invoke-RestMethod -Method Post -Uri "https://www.googleapis.com/admin/directory/v1/users" -Headers @{Authorization = "Bearer "+(Get-GoogleToken)} -Body (ConvertTo-Json $body) -ContentType 'application/json; charset=utf-8'
    }
    "AddMember" {
      $body = @{
        userKey = $query['email']
      }
      $ifrequest = Invoke-RestMethod -Method Get -Uri "https://www.googleapis.com/admin/directory/v1/groups" -Headers @{Authorization = "Bearer "+(Get-GoogleToken)} -Body $body
      $array = @()
      foreach ($group in $ifrequest.groups) {$array += $group.email}
      if ($array -notcontains $query['groupkey']) {
        $body = @{
          email = $query['email']
          role = "MEMBER"
        }
        Return Invoke-RestMethod -Method Post -Uri ("https://www.googleapis.com/admin/directory/v1/groups/"+$query['groupkey']+"/members") -Headers @{Authorization = "Bearer "+(Get-GoogleToken)} -Body (ConvertTo-Json $body) -ContentType 'application/json; charset=utf-8'
      } else {
        Return ($query['email']+" now is a member of "+$query['groupkey'])
      }
    }
  }
}

တောင်းဆိုချက်တစ်ခုစီတွင်၊ တိုကင်အမျိုးအစားနှင့် Access token ကိုယ်တိုင်ပါရှိသော ခွင့်ပြုချက်ခေါင်းစီးကို ပေးပို့ရန် လိုအပ်သည်။ လက်ရှိတွင်၊ တိုကင်အမျိုးအစားသည် အမြဲတမ်း Bearer ဖြစ်သည်။ ဘာဖြစ်လို့လဲဆိုတော့ တိုကင်သက်တမ်းမကုန်သေးကြောင်း စစ်ဆေးရန် လိုအပ်ပြီး ၎င်းကိုထုတ်ပေးသည့်အချိန်မှ တစ်နာရီအကြာတွင် ၎င်းကို အပ်ဒိတ်လုပ်ရန် လိုအပ်သည်၊ ကျွန်ုပ်သည် Access token ကို ပြန်ပေးသည့် အခြားလုပ်ဆောင်မှုတစ်ခုအတွက် တောင်းဆိုချက်ကို သတ်မှတ်ပေးပါသည်။ ပထမဆုံး Access token ကိုလက်ခံရရှိသောအခါ တူညီသောကုဒ်အပိုင်းသည် script ၏အစတွင်ဖြစ်သည်။

function Get-GoogleToken {
  if (((Get-date).Hour -gt $token_expire.hour) -or (((Get-date).Hour -ge $token_expire.hour) -and ((Get-date).Minute -gt $token_expire.minute))) {
  Write-Host "Token Expired. Refreshing..."
    $request = (Invoke-RestMethod -Method Post -Uri "https://www.googleapis.com/oauth2/v4/token" -ContentType 'application/x-www-form-urlencoded' -Body @{
      client_id = $client_id
      client_secret = $client_secret
      refresh_token = $refresh_token
      grant_type = 'refresh_token'
    })
    $token = $request.access_token
    $minute = ([int]("{0:mm}" -f ([timespan]::fromseconds($request.expires_in))))+((Get-date).Minute)-2
    if ($minute -lt 0) {$minute += 60}
    elseif ($minute -gt 59) {$minute -=60}
    $script:token_expire = @{
      hour = ([int]("{0:hh}" -f ([timespan]::fromseconds($request.expires_in))))+((Get-date).Hour)
      minute = $minute
    }
  }
  return $token
}

တည်ရှိမှုအတွက် အကောင့်ကို စစ်ဆေးခြင်း-

function Check_Google {
  $query = (GoogleQuery 'SearchAccount' $username)
  if ($query.users -ne $null) {
    $user = $query.users[0]
    Write-Host $user.name.fullName' - '$user.PrimaryEmail' - suspended: '$user.Suspended
    $GAresult = $user
  }
  if ($GAresult) {
      $return = $GAresult
  } else {$return = 'gg'}
  return $return
}

အီးမေးလ်:$query တောင်းဆိုချက်သည် နာမည်တူများအပါအဝင် ထိုအီးမေးလ်အတိအကျရှိသော သုံးစွဲသူကို ရှာဖွေရန် API အား တောင်းဆိုမည်ဖြစ်သည်။ ခရင်မ်ကတ်ကိုလည်း သုံးနိုင်သည်- =, :, :{PREFIX}*.

ဒေတာရယူရန်၊ GET တောင်းဆိုမှုနည်းလမ်းကို အသုံးပြုပါ၊ ဒေတာထည့်သွင်းရန် (အကောင့်တစ်ခုဖန်တီးခြင်း သို့မဟုတ် အဖွဲ့ဝင်တစ်ဦးကို အဖွဲ့တစ်ခုသို့ထည့်ခြင်း) - POST၊ ရှိပြီးသားဒေတာကို အပ်ဒိတ်လုပ်ရန် - PUT၊ မှတ်တမ်းတစ်ခုကို ဖျက်ရန် (ဥပမာ၊ အဖွဲ့တစ်ခုမှ အဖွဲ့ဝင်တစ်ဦး) - ဖျက်ပါ။

Script သည် ဖုန်းနံပါတ်တစ်ခု (တရားမဝင်သော စာကြောင်းတစ်ခု) နှင့် ဒေသဆိုင်ရာ ဖြန့်ဖြူးရေးအဖွဲ့တွင် ပါဝင်ရန်အတွက်လည်း တောင်းဆိုပါမည်။ ၎င်းသည် ရွေးချယ်ထားသော Active Directory OU ကိုအခြေခံ၍ အသုံးပြုသူတွင် မည်သည့်အဖွဲ့အစည်းယူနစ်ကို ဆုံးဖြတ်ပေးပြီး စကားဝှက်တစ်ခုပေါ်လာသည်-

do {
  $phone = Read-Host "Телефон в формате +7хххххххх"
} while (-not $phone)
do {
    $moscow = Read-Host "В Московский офис? (y/n) "
} while (-not (($moscow -eq 'y') -or ($moscow -eq 'n')))
$orgunit = '/'
if ($OU -like "*OU=Delivery,OU=Users,OU=ROOT,DC=rocket,DC=local") {
    Write-host "Будет создана в /Team delivery"
    $orgunit = "/Team delivery"
}
$Password =  -join ( 48..57 + 65..90 + 97..122 | Get-Random -Count 12 | % {[char]$_})+"*Ba"

ပြီးတော့ သူက အကောင့်ကို ခြယ်လှယ်ဖို့ စတင်တယ်။

$query = @{
  email = $email
  givenName = $firstname
  familyName = $lastname
  password = $password
  phone = $phone
  orgunit = $orgunit
}
if ($GMailExist) {
  Write-Host "Запускаем изменение аккаунта" -f mag
  (GoogleQuery 'UpdateAccount' $query) | fl
  write-host "Не забудь проверить группы у включенного $Username в Google."
} else {
  Write-Host "Запускаем создание аккаунта" -f mag
  (GoogleQuery 'CreateAccount' $query) | fl
}
if ($moscow -eq "y"){
  write-host "Добавляем в группу moscowoffice"
  $query = @{
    groupkey = '[email protected]'
    email = $email
  }
  (GoogleQuery 'AddMember' $query) | fl
}

အကောင့်တစ်ခုကို အပ်ဒိတ်လုပ်ခြင်းနှင့် ဖန်တီးခြင်းအတွက် လုပ်ဆောင်ချက်များတွင် ဆင်တူသော အထားအသိုတစ်ခုပါရှိသည်၊ အပိုအကွက်များအားလုံးကို မလိုအပ်ပါ၊ ဖုန်းနံပါတ်များပါသည့် ကဏ္ဍတွင်၊ နံပါတ်နှင့် ၎င်း၏အမျိုးအစားနှင့် စံချိန်တစ်ခုအထိ ပါဝင်နိုင်သည့် ခင်းကျင်းတစ်ခုကို သင်သတ်မှတ်ရန် လိုအပ်ပါသည်။

အဖွဲ့တစ်ခုသို့ အသုံးပြုသူတစ်ဦးကို ထည့်သည့်အခါ အမှားအယွင်းတစ်ခုမရရှိစေရန်၊ အသုံးပြုသူကိုယ်တိုင်မှ အဖွဲ့၀င်စာရင်း သို့မဟုတ် ပေါင်းစပ်ဖွဲ့စည်းမှုကို ရယူခြင်းဖြင့် ၎င်းသည် ဤအဖွဲ့၏အဖွဲ့ဝင်ဖြစ်ခြင်းရှိ၊ မရှိကို ဦးစွာစစ်ဆေးနိုင်ပါသည်။

သတ်သတ်မှတ်မှတ်အသုံးပြုသူတစ်ဦး၏ အဖွဲ့အဖွဲ့ဝင်ဖြစ်မှုကို စုံစမ်းမေးမြန်းခြင်းသည် ထပ်ခါတလဲလဲလုပ်ဆောင်မည်မဟုတ်သည့်အပြင် တိုက်ရိုက်အဖွဲ့ဝင်ခြင်းကိုသာ ပြသမည်ဖြစ်သည်။ အသုံးပြုသူအဖွဲ့ဝင်ဖြစ်ထားသည့် ကလေးအဖွဲ့ရှိပြီးသား မိခင်အဖွဲ့တွင် အသုံးပြုသူတစ်ဦးအပါအဝင် အောင်မြင်မည်ဖြစ်သည်။

ကောက်ချက်

ကျန်တာအားလုံးက အကောင့်အသစ်အတွက် စကားဝှက်ကို သုံးစွဲသူထံ ပေးပို့ရန်ဖြစ်သည်။ ကျွန်ုပ်တို့သည် ၎င်းကို SMS မှတစ်ဆင့်လုပ်ဆောင်ပြီး အထွေထွေအချက်အလက်များကို ညွှန်ကြားချက်များနှင့်အတူ စုဆောင်းရေးဌာနမှ ပေးဆောင်ထားသည့် ဖုန်းနံပါတ်တစ်ခုနှင့်အတူ ကိုယ်ရေးကိုယ်တာအီးမေးလ်သို့ ဝင်ရောက်ပြီး အထွေထွေအချက်အလက်များကို ပေးပို့ပါသည်။ အခြားရွေးချယ်စရာအနေဖြင့်၊ သင်သည် ငွေစုနိုင်ပြီး သင်၏စကားဝှက်ကို လျှို့ဝှက်ကြေးနန်းစကားပြောခန်းသို့ ပေးပို့နိုင်သည်၊ ၎င်းသည် ဒုတိယအချက်ဟု ယူဆနိုင်သည် (MacBooks သည် ချွင်းချက်တစ်ခုဖြစ်လိမ့်မည်)။

အဆုံးထိဖတ်ပေးလို့ ကျေးဇူးတင်ပါတယ်။ ဆောင်းပါးရေးဟန်ကို ပိုမိုကောင်းမွန်လာစေရန်အတွက် အကြံပြုချက်များကို မြင်တွေ့ရသည့်အတွက် ဝမ်းမြောက်မိပြီး Script များရေးသားရာတွင် အမှားအယွင်းများ နည်းပါးလာစေရန် ဆုတောင်းပေးပါသည်။ =)

အကြောင်းအရာအရ အသုံးဝင်နိုင်သော သို့မဟုတ် မေးခွန်းများကို ဖြေရန် လင့်ခ်များစာရင်း-

• မိုဘိုင်းနှင့် ဒက်စ်တော့အက်ပ်များအတွက် OAuth 2.0
• Web Server Applications အတွက် OAuth 2.0 ကို အသုံးပြုခြင်း။
• OAuth အများသူငှာဖောက်သည်များ၏ Code Exchange အတွက် အထောက်အထားကီး
• PowerShell ဖြင့် ကျပန်းစာလုံးများကို ဖန်တီးပါ။
• ASCII ဇယားနှင့်ဖော်ပြချက်
• PowerShell- စာကြောင်းတစ်ခုအတွက် hash တန်ဖိုးကို ရယူခြင်း။
• Encode/Decode Base64Url
• Base64 ကုဒ်နှင့် Base64url ကုဒ်နံပါတ်
• PowerShell 5.1 တွင် Invoke-RestMethod
• access_type သည် အဆင့် 1 တွင် အော့ဖ်လိုင်းဖြစ်နေသော်လည်း refresh တိုကင်မရပါ။
• နှိုင်းယှဉ်အော်ပရေတာများအကြောင်း
• လမ်းညွှန် API- အသုံးပြုသူအကောင့်များ
• အသုံးပြုသူများကို ရှာဖွေပါ။
• လမ်းညွှန် API- အုပ်စုများ
• Invoke-RestMethod အတွက် အမှားအယွင်း ကိုင်တွယ်ခြင်း - Powershell

source: www.habr.com