sd.go 4.3 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133
  1. //go:build windows
  2. // +build windows
  3. package winio
  4. import (
  5. "errors"
  6. "fmt"
  7. "unsafe"
  8. "golang.org/x/sys/windows"
  9. )
  10. //sys lookupAccountName(systemName *uint16, accountName string, sid *byte, sidSize *uint32, refDomain *uint16, refDomainSize *uint32, sidNameUse *uint32) (err error) = advapi32.LookupAccountNameW
  11. //sys lookupAccountSid(systemName *uint16, sid *byte, name *uint16, nameSize *uint32, refDomain *uint16, refDomainSize *uint32, sidNameUse *uint32) (err error) = advapi32.LookupAccountSidW
  12. //sys convertSidToStringSid(sid *byte, str **uint16) (err error) = advapi32.ConvertSidToStringSidW
  13. //sys convertStringSidToSid(str *uint16, sid **byte) (err error) = advapi32.ConvertStringSidToSidW
  14. type AccountLookupError struct {
  15. Name string
  16. Err error
  17. }
  18. func (e *AccountLookupError) Error() string {
  19. if e.Name == "" {
  20. return "lookup account: empty account name specified"
  21. }
  22. var s string
  23. switch {
  24. case errors.Is(e.Err, windows.ERROR_INVALID_SID):
  25. s = "the security ID structure is invalid"
  26. case errors.Is(e.Err, windows.ERROR_NONE_MAPPED):
  27. s = "not found"
  28. default:
  29. s = e.Err.Error()
  30. }
  31. return "lookup account " + e.Name + ": " + s
  32. }
  33. func (e *AccountLookupError) Unwrap() error { return e.Err }
  34. type SddlConversionError struct {
  35. Sddl string
  36. Err error
  37. }
  38. func (e *SddlConversionError) Error() string {
  39. return "convert " + e.Sddl + ": " + e.Err.Error()
  40. }
  41. func (e *SddlConversionError) Unwrap() error { return e.Err }
  42. // LookupSidByName looks up the SID of an account by name
  43. //
  44. //revive:disable-next-line:var-naming SID, not Sid
  45. func LookupSidByName(name string) (sid string, err error) {
  46. if name == "" {
  47. return "", &AccountLookupError{name, windows.ERROR_NONE_MAPPED}
  48. }
  49. var sidSize, sidNameUse, refDomainSize uint32
  50. err = lookupAccountName(nil, name, nil, &sidSize, nil, &refDomainSize, &sidNameUse)
  51. if err != nil && err != windows.ERROR_INSUFFICIENT_BUFFER { //nolint:errorlint // err is Errno
  52. return "", &AccountLookupError{name, err}
  53. }
  54. sidBuffer := make([]byte, sidSize)
  55. refDomainBuffer := make([]uint16, refDomainSize)
  56. err = lookupAccountName(nil, name, &sidBuffer[0], &sidSize, &refDomainBuffer[0], &refDomainSize, &sidNameUse)
  57. if err != nil {
  58. return "", &AccountLookupError{name, err}
  59. }
  60. var strBuffer *uint16
  61. err = convertSidToStringSid(&sidBuffer[0], &strBuffer)
  62. if err != nil {
  63. return "", &AccountLookupError{name, err}
  64. }
  65. sid = windows.UTF16ToString((*[0xffff]uint16)(unsafe.Pointer(strBuffer))[:])
  66. _, _ = windows.LocalFree(windows.Handle(unsafe.Pointer(strBuffer)))
  67. return sid, nil
  68. }
  69. // LookupNameBySid looks up the name of an account by SID
  70. //
  71. //revive:disable-next-line:var-naming SID, not Sid
  72. func LookupNameBySid(sid string) (name string, err error) {
  73. if sid == "" {
  74. return "", &AccountLookupError{sid, windows.ERROR_NONE_MAPPED}
  75. }
  76. sidBuffer, err := windows.UTF16PtrFromString(sid)
  77. if err != nil {
  78. return "", &AccountLookupError{sid, err}
  79. }
  80. var sidPtr *byte
  81. if err = convertStringSidToSid(sidBuffer, &sidPtr); err != nil {
  82. return "", &AccountLookupError{sid, err}
  83. }
  84. defer windows.LocalFree(windows.Handle(unsafe.Pointer(sidPtr))) //nolint:errcheck
  85. var nameSize, refDomainSize, sidNameUse uint32
  86. err = lookupAccountSid(nil, sidPtr, nil, &nameSize, nil, &refDomainSize, &sidNameUse)
  87. if err != nil && err != windows.ERROR_INSUFFICIENT_BUFFER { //nolint:errorlint // err is Errno
  88. return "", &AccountLookupError{sid, err}
  89. }
  90. nameBuffer := make([]uint16, nameSize)
  91. refDomainBuffer := make([]uint16, refDomainSize)
  92. err = lookupAccountSid(nil, sidPtr, &nameBuffer[0], &nameSize, &refDomainBuffer[0], &refDomainSize, &sidNameUse)
  93. if err != nil {
  94. return "", &AccountLookupError{sid, err}
  95. }
  96. name = windows.UTF16ToString(nameBuffer)
  97. return name, nil
  98. }
  99. func SddlToSecurityDescriptor(sddl string) ([]byte, error) {
  100. sd, err := windows.SecurityDescriptorFromString(sddl)
  101. if err != nil {
  102. return nil, &SddlConversionError{Sddl: sddl, Err: err}
  103. }
  104. b := unsafe.Slice((*byte)(unsafe.Pointer(sd)), sd.Length())
  105. return b, nil
  106. }
  107. func SecurityDescriptorToSddl(sd []byte) (string, error) {
  108. if l := int(unsafe.Sizeof(windows.SECURITY_DESCRIPTOR{})); len(sd) < l {
  109. return "", fmt.Errorf("SecurityDescriptor (%d) smaller than expected (%d): %w", len(sd), l, windows.ERROR_INCORRECT_SIZE)
  110. }
  111. s := (*windows.SECURITY_DESCRIPTOR)(unsafe.Pointer(&sd[0]))
  112. return s.String(), nil
  113. }