PeerTube/server/lib/activitypub/actor.ts

515 lines
16 KiB
TypeScript
Raw Normal View History

2017-12-14 17:38:41 +01:00
import * as Bluebird from 'bluebird'
import { Transaction } from 'sequelize'
2020-01-31 16:56:52 +01:00
import { URL } from 'url'
2020-02-28 16:03:39 +01:00
import { v4 as uuidv4 } from 'uuid'
import { ActivityPubActor, ActivityPubActorType, ActivityPubOrderedCollection } from '../../../shared/models/activitypub'
2017-12-14 17:38:41 +01:00
import { ActivityPubAttributedTo } from '../../../shared/models/activitypub/objects'
import { checkUrlsSameHost, getAPId } from '../../helpers/activitypub'
2019-05-31 15:36:50 +02:00
import { sanitizeAndCheckActorObject } from '../../helpers/custom-validators/activitypub/actor'
2017-12-29 19:10:13 +01:00
import { isActivityPubUrlValid } from '../../helpers/custom-validators/activitypub/misc'
2018-01-04 14:04:02 +01:00
import { retryTransactionWrapper, updateInstanceWithAnother } from '../../helpers/database-utils'
2017-12-28 11:16:08 +01:00
import { logger } from '../../helpers/logger'
import { createPrivateAndPublicKeys } from '../../helpers/peertube-crypto'
2019-08-09 11:32:40 +02:00
import { doRequest } from '../../helpers/requests'
2018-01-04 14:04:02 +01:00
import { getUrlFromWebfinger } from '../../helpers/webfinger'
2019-08-09 11:32:40 +02:00
import { MIMETYPES, WEBSERVER } from '../../initializers/constants'
2017-12-14 17:38:41 +01:00
import { AccountModel } from '../../models/account/account'
import { ActorModel } from '../../models/activitypub/actor'
2017-12-29 19:10:13 +01:00
import { AvatarModel } from '../../models/avatar/avatar'
2017-12-14 17:38:41 +01:00
import { ServerModel } from '../../models/server/server'
import { VideoChannelModel } from '../../models/video/video-channel'
2018-05-25 11:17:41 +02:00
import { JobQueue } from '../job-queue'
import { getServerActor } from '../../helpers/utils'
import { ActorFetchByUrlType, fetchActorByUrl } from '../../helpers/actor'
import { sequelizeTypescript } from '../../initializers/database'
2019-08-15 11:53:26 +02:00
import {
MAccount,
2019-08-20 13:52:49 +02:00
MAccountDefault,
2019-08-15 11:53:26 +02:00
MActor,
MActorAccountChannelId,
2019-08-20 13:52:49 +02:00
MActorAccountChannelIdActor,
2019-08-15 11:53:26 +02:00
MActorAccountId,
MActorDefault,
MActorFull,
2019-08-20 13:52:49 +02:00
MActorFullActor,
2019-08-15 11:53:26 +02:00
MActorId,
2020-01-31 16:56:52 +01:00
MChannel
2019-08-15 11:53:26 +02:00
} from '../../typings/models'
import { extname } from 'path'
2017-12-14 17:38:41 +01:00
2017-12-19 10:34:56 +01:00
// Set account keys, this could be long so process after the account creation and do not block the client
2019-08-20 19:05:31 +02:00
function setAsyncActorKeys <T extends MActor> (actor: T) {
2017-12-14 17:38:41 +01:00
return createPrivateAndPublicKeys()
.then(({ publicKey, privateKey }) => {
2019-08-15 11:53:26 +02:00
actor.publicKey = publicKey
actor.privateKey = privateKey
2017-12-14 17:38:41 +01:00
return actor.save()
})
.catch(err => {
2019-05-31 14:02:26 +02:00
logger.error('Cannot set public/private keys of actor %d.', actor.url, { err })
2017-12-14 17:38:41 +01:00
return actor
})
}
2019-08-15 11:53:26 +02:00
function getOrCreateActorAndServerAndModel (
activityActor: string | ActivityPubActor,
fetchType: 'all',
recurseIfNeeded?: boolean,
updateCollections?: boolean
): Promise<MActorFullActor>
function getOrCreateActorAndServerAndModel (
activityActor: string | ActivityPubActor,
fetchType?: 'association-ids',
recurseIfNeeded?: boolean,
updateCollections?: boolean
): Promise<MActorAccountChannelId>
2018-08-24 15:36:50 +02:00
async function getOrCreateActorAndServerAndModel (
activityActor: string | ActivityPubActor,
2019-08-15 11:53:26 +02:00
fetchType: ActorFetchByUrlType = 'association-ids',
2018-08-24 15:36:50 +02:00
recurseIfNeeded = true,
updateCollections = false
2019-08-15 11:53:26 +02:00
): Promise<MActorFullActor | MActorAccountChannelId> {
const actorUrl = getAPId(activityActor)
2018-08-24 15:36:50 +02:00
let created = false
2019-02-26 10:55:40 +01:00
let accountPlaylistsUrl: string
let actor = await fetchActorByUrl(actorUrl, fetchType)
2018-07-31 11:04:33 +02:00
// Orphan actor (not associated to an account of channel) so recreate it
if (actor && (!actor.Account && !actor.VideoChannel)) {
2018-07-31 11:04:33 +02:00
await actor.destroy()
actor = null
}
2017-12-14 17:38:41 +01:00
// We don't have this actor in our database, fetch it on remote
if (!actor) {
2018-08-24 11:04:02 +02:00
const { result } = await fetchRemoteActor(actorUrl)
if (result === undefined) throw new Error('Cannot fetch remote actor ' + actorUrl)
2017-12-14 17:38:41 +01:00
// Create the attributed to actor
// In PeerTube a video channel is owned by an account
2019-08-15 11:53:26 +02:00
let ownerActor: MActorFullActor
2017-12-14 17:38:41 +01:00
if (recurseIfNeeded === true && result.actor.type === 'Group') {
const accountAttributedTo = result.attributedTo.find(a => a.type === 'Person')
if (!accountAttributedTo) throw new Error('Cannot find account attributed to video channel ' + actor.url)
2018-11-14 15:01:28 +01:00
if (checkUrlsSameHost(accountAttributedTo.id, actorUrl) !== true) {
throw new Error(`Account attributed to ${accountAttributedTo.id} does not have the same host than actor url ${actorUrl}`)
}
2017-12-14 17:38:41 +01:00
try {
2018-11-14 15:01:28 +01:00
// Don't recurse another time
2019-02-26 10:55:40 +01:00
const recurseIfNeeded = false
ownerActor = await getOrCreateActorAndServerAndModel(accountAttributedTo.id, 'all', recurseIfNeeded)
2017-12-14 17:38:41 +01:00
} catch (err) {
logger.error('Cannot get or create account attributed to video channel ' + actor.url)
throw new Error(err)
}
}
2018-06-13 14:27:40 +02:00
actor = await retryTransactionWrapper(saveActorAndServerAndModelIfNotExist, result, ownerActor)
2018-08-24 15:36:50 +02:00
created = true
2019-02-26 10:55:40 +01:00
accountPlaylistsUrl = result.playlists
2017-12-14 17:38:41 +01:00
}
2019-08-15 11:53:26 +02:00
if (actor.Account) (actor as MActorAccountChannelIdActor).Account.Actor = actor
if (actor.VideoChannel) (actor as MActorAccountChannelIdActor).VideoChannel.Actor = actor
const { actor: actorRefreshed, refreshed } = await retryTransactionWrapper(refreshActorIfNeeded, actor, fetchType)
2018-08-24 15:36:50 +02:00
if (!actorRefreshed) throw new Error('Actor ' + actorRefreshed.url + ' does not exist anymore.')
2018-08-24 11:04:02 +02:00
2018-08-24 15:36:50 +02:00
if ((created === true || refreshed === true) && updateCollections === true) {
const payload = { uri: actor.outboxUrl, type: 'activity' as 'activity' }
2020-01-31 16:56:52 +01:00
await JobQueue.Instance.createJobWithPromise({ type: 'activitypub-http-fetcher', payload })
2018-08-24 15:36:50 +02:00
}
2019-02-26 10:55:40 +01:00
// We created a new account: fetch the playlists
if (created === true && actor.Account && accountPlaylistsUrl) {
const payload = { uri: accountPlaylistsUrl, accountId: actor.Account.id, type: 'account-playlists' as 'account-playlists' }
2020-01-31 16:56:52 +01:00
await JobQueue.Instance.createJobWithPromise({ type: 'activitypub-http-fetcher', payload })
2019-02-26 10:55:40 +01:00
}
2018-08-24 15:36:50 +02:00
return actorRefreshed
2017-12-14 17:38:41 +01:00
}
2017-12-29 19:10:13 +01:00
function buildActorInstance (type: ActivityPubActorType, url: string, preferredUsername: string, uuid?: string) {
return new ActorModel({
type,
url,
preferredUsername,
uuid,
publicKey: null,
privateKey: null,
followersCount: 0,
followingCount: 0,
inboxUrl: url + '/inbox',
outboxUrl: url + '/outbox',
2019-04-11 11:33:44 +02:00
sharedInboxUrl: WEBSERVER.URL + '/inbox',
2017-12-29 19:10:13 +01:00
followersUrl: url + '/followers',
followingUrl: url + '/following'
2019-08-20 19:05:31 +02:00
}) as MActor
2017-12-29 19:10:13 +01:00
}
2018-01-04 14:04:02 +01:00
async function updateActorInstance (actorInstance: ActorModel, attributes: ActivityPubActor) {
const followersCount = await fetchActorTotalItems(attributes.followers)
const followingCount = await fetchActorTotalItems(attributes.following)
2019-05-31 14:02:26 +02:00
actorInstance.type = attributes.type
actorInstance.preferredUsername = attributes.preferredUsername
actorInstance.url = attributes.id
actorInstance.publicKey = attributes.publicKey.publicKeyPem
actorInstance.followersCount = followersCount
actorInstance.followingCount = followingCount
actorInstance.inboxUrl = attributes.inbox
actorInstance.outboxUrl = attributes.outbox
actorInstance.followersUrl = attributes.followers
actorInstance.followingUrl = attributes.following
if (attributes.endpoints && attributes.endpoints.sharedInbox) {
actorInstance.sharedInboxUrl = attributes.endpoints.sharedInbox
}
2018-01-04 14:04:02 +01:00
}
2019-08-15 11:53:26 +02:00
type AvatarInfo = { name: string, onDisk: boolean, fileUrl: string }
async function updateActorAvatarInstance (actor: MActorDefault, info: AvatarInfo, t: Transaction) {
2019-11-21 12:16:27 +01:00
if (!info.name) return actor
2018-01-04 14:04:02 +01:00
2019-11-21 12:16:27 +01:00
if (actor.Avatar) {
2020-02-17 15:33:42 +01:00
// Don't update the avatar if the file URL did not change
if (info.fileUrl && actor.Avatar.fileUrl === info.fileUrl) return actor
2018-01-04 14:04:02 +01:00
2019-11-21 12:16:27 +01:00
try {
await actor.Avatar.destroy({ transaction: t })
} catch (err) {
logger.error('Cannot remove old avatar of actor %s.', actor.url, { err })
}
2018-01-04 14:04:02 +01:00
}
2019-11-21 12:16:27 +01:00
const avatar = await AvatarModel.create({
filename: info.name,
onDisk: info.onDisk,
fileUrl: info.fileUrl
}, { transaction: t })
actor.avatarId = avatar.id
actor.Avatar = avatar
2019-08-09 11:32:40 +02:00
return actor
2018-01-04 14:04:02 +01:00
}
2018-01-03 16:38:50 +01:00
async function fetchActorTotalItems (url: string) {
const options = {
uri: url,
method: 'GET',
json: true,
activityPub: true
}
try {
2020-02-28 16:03:39 +01:00
const { body } = await doRequest<ActivityPubOrderedCollection<unknown>>(options)
2018-01-15 09:46:46 +01:00
return body.totalItems ? body.totalItems : 0
2018-01-03 16:38:50 +01:00
} catch (err) {
2018-03-26 15:54:13 +02:00
logger.warn('Cannot fetch remote actor count %s.', url, { err })
2018-01-15 09:46:46 +01:00
return 0
2018-01-03 16:38:50 +01:00
}
}
2020-01-31 16:56:52 +01:00
function getAvatarInfoIfExists (actorJSON: ActivityPubActor) {
const mimetypes = MIMETYPES.IMAGE
const icon = actorJSON.icon
if (!icon || icon.type !== 'Image' || !isActivityPubUrlValid(icon.url)) return undefined
2018-01-03 16:38:50 +01:00
2020-02-12 10:26:35 +01:00
let extension: string
if (icon.mediaType) {
extension = mimetypes.MIMETYPE_EXT[icon.mediaType]
} else {
const tmp = extname(icon.url)
if (mimetypes.EXT_MIMETYPE[tmp] !== undefined) extension = tmp
}
if (!extension) return undefined
return {
name: uuidv4() + extension,
fileUrl: icon.url
}
2018-01-03 16:38:50 +01:00
}
async function addFetchOutboxJob (actor: Pick<ActorModel, 'id' | 'outboxUrl'>) {
2018-05-25 11:17:41 +02:00
// Don't fetch ourselves
const serverActor = await getServerActor()
if (serverActor.id === actor.id) {
logger.error('Cannot fetch our own outbox!')
return undefined
}
const payload = {
uri: actor.outboxUrl,
type: 'activity' as 'activity'
2018-05-25 11:17:41 +02:00
}
return JobQueue.Instance.createJob({ type: 'activitypub-http-fetcher', payload })
}
2019-08-15 11:53:26 +02:00
async function refreshActorIfNeeded <T extends MActorFull | MActorAccountChannelId> (
actorArg: T,
2019-01-14 11:30:15 +01:00
fetchedType: ActorFetchByUrlType
2019-08-15 11:53:26 +02:00
): Promise<{ actor: T | MActorFull, refreshed: boolean }> {
2019-01-14 11:30:15 +01:00
if (!actorArg.isOutdated()) return { actor: actorArg, refreshed: false }
// We need more attributes
2019-08-15 11:53:26 +02:00
const actor = fetchedType === 'all'
? actorArg as MActorFull
: await ActorModel.loadByUrlAndPopulateAccountAndChannel(actorArg.url)
2019-01-14 11:30:15 +01:00
try {
2019-01-14 12:11:06 +01:00
let actorUrl: string
try {
actorUrl = await getUrlFromWebfinger(actor.preferredUsername + '@' + actor.getHost())
} catch (err) {
logger.warn('Cannot get actor URL from webfinger, keeping the old one.', err)
actorUrl = actor.url
}
2019-01-14 11:30:15 +01:00
const { result, statusCode } = await fetchRemoteActor(actorUrl)
if (statusCode === 404) {
logger.info('Deleting actor %s because there is a 404 in refresh actor.', actor.url)
2020-01-31 16:56:52 +01:00
actor.Account
? await actor.Account.destroy()
: await actor.VideoChannel.destroy()
2019-01-14 11:30:15 +01:00
return { actor: undefined, refreshed: false }
}
if (result === undefined) {
logger.warn('Cannot fetch remote actor in refresh actor.')
return { actor, refreshed: false }
}
return sequelizeTypescript.transaction(async t => {
updateInstanceWithAnother(actor, result.actor)
2019-08-09 11:32:40 +02:00
if (result.avatar !== undefined) {
const avatarInfo = {
name: result.avatar.name,
fileUrl: result.avatar.fileUrl,
onDisk: false
}
await updateActorAvatarInstance(actor, avatarInfo, t)
2019-01-14 11:30:15 +01:00
}
// Force update
actor.setDataValue('updatedAt', new Date())
await actor.save({ transaction: t })
if (actor.Account) {
2019-08-06 17:19:53 +02:00
actor.Account.name = result.name
actor.Account.description = result.summary
2019-01-14 11:30:15 +01:00
await actor.Account.save({ transaction: t })
} else if (actor.VideoChannel) {
2019-08-06 17:19:53 +02:00
actor.VideoChannel.name = result.name
actor.VideoChannel.description = result.summary
actor.VideoChannel.support = result.support
2019-01-14 11:30:15 +01:00
await actor.VideoChannel.save({ transaction: t })
}
return { refreshed: true, actor }
})
} catch (err) {
logger.warn('Cannot refresh actor %s.', actor.url, { err })
2019-01-14 11:30:15 +01:00
return { actor, refreshed: false }
}
}
2017-12-29 19:10:13 +01:00
export {
getOrCreateActorAndServerAndModel,
buildActorInstance,
2018-01-03 16:38:50 +01:00
setAsyncActorKeys,
fetchActorTotalItems,
2019-08-09 11:32:40 +02:00
getAvatarInfoIfExists,
2018-01-04 14:04:02 +01:00
updateActorInstance,
2019-01-14 11:30:15 +01:00
refreshActorIfNeeded,
2018-05-25 11:17:41 +02:00
updateActorAvatarInstance,
addFetchOutboxJob
2017-12-29 19:10:13 +01:00
}
// ---------------------------------------------------------------------------
2017-12-14 17:38:41 +01:00
function saveActorAndServerAndModelIfNotExist (
result: FetchRemoteActorResult,
2019-08-15 11:53:26 +02:00
ownerActor?: MActorFullActor,
2017-12-14 17:38:41 +01:00
t?: Transaction
2019-08-15 11:53:26 +02:00
): Bluebird<MActorFullActor> | Promise<MActorFullActor> {
2020-01-31 16:56:52 +01:00
const actor = result.actor
2017-12-14 17:38:41 +01:00
if (t !== undefined) return save(t)
return sequelizeTypescript.transaction(t => save(t))
async function save (t: Transaction) {
2020-01-31 16:56:52 +01:00
const actorHost = new URL(actor.url).host
2017-12-14 17:38:41 +01:00
const serverOptions = {
where: {
host: actorHost
},
defaults: {
host: actorHost
},
transaction: t
}
const [ server ] = await ServerModel.findOrCreate(serverOptions)
// Save our new account in database
2019-08-09 11:32:40 +02:00
actor.serverId = server.id
2017-12-14 17:38:41 +01:00
2017-12-29 19:10:13 +01:00
// Avatar?
2019-08-09 11:32:40 +02:00
if (result.avatar) {
2017-12-29 19:10:13 +01:00
const avatar = await AvatarModel.create({
2019-08-09 11:32:40 +02:00
filename: result.avatar.name,
fileUrl: result.avatar.fileUrl,
onDisk: false
2017-12-29 19:10:13 +01:00
}, { transaction: t })
2019-08-09 11:32:40 +02:00
actor.avatarId = avatar.id
2017-12-29 19:10:13 +01:00
}
2017-12-14 17:38:41 +01:00
// Force the actor creation, sometimes Sequelize skips the save() when it thinks the instance already exists
// (which could be false in a retried query)
2019-08-15 11:53:26 +02:00
const [ actorCreated ] = await ActorModel.findOrCreate<MActorFullActor>({
defaults: actor.toJSON(),
where: {
url: actor.url
},
transaction: t
})
2017-12-14 17:38:41 +01:00
if (actorCreated.type === 'Person' || actorCreated.type === 'Application') {
2019-08-20 13:52:49 +02:00
actorCreated.Account = await saveAccount(actorCreated, result, t) as MAccountDefault
2017-12-14 17:38:41 +01:00
actorCreated.Account.Actor = actorCreated
} else if (actorCreated.type === 'Group') { // Video channel
2019-08-20 13:52:49 +02:00
const channel = await saveVideoChannel(actorCreated, result, ownerActor, t)
actorCreated.VideoChannel = Object.assign(channel, { Actor: actorCreated, Account: ownerActor.Account })
2017-12-14 17:38:41 +01:00
}
actorCreated.Server = server
2017-12-14 17:38:41 +01:00
return actorCreated
}
}
type FetchRemoteActorResult = {
2019-08-15 11:53:26 +02:00
actor: MActor
2017-12-19 10:34:56 +01:00
name: string
2017-12-14 17:38:41 +01:00
summary: string
support?: string
2019-02-26 10:55:40 +01:00
playlists?: string
2019-08-09 11:32:40 +02:00
avatar?: {
2020-01-31 16:56:52 +01:00
name: string
2019-08-09 11:32:40 +02:00
fileUrl: string
}
2017-12-14 17:38:41 +01:00
attributedTo: ActivityPubAttributedTo[]
}
2018-08-24 11:04:02 +02:00
async function fetchRemoteActor (actorUrl: string): Promise<{ statusCode?: number, result: FetchRemoteActorResult }> {
2017-12-14 17:38:41 +01:00
const options = {
uri: actorUrl,
method: 'GET',
2017-12-28 11:16:08 +01:00
json: true,
activityPub: true
2017-12-14 17:38:41 +01:00
}
logger.info('Fetching remote actor %s.', actorUrl)
const requestResult = await doRequest<ActivityPubActor>(options)
const actorJSON = requestResult.body
2019-05-31 15:36:50 +02:00
if (sanitizeAndCheckActorObject(actorJSON) === false) {
logger.debug('Remote actor JSON is not valid.', { actorJSON })
2018-08-24 11:04:02 +02:00
return { result: undefined, statusCode: requestResult.response.statusCode }
2017-12-14 17:38:41 +01:00
}
2018-11-14 15:01:28 +01:00
if (checkUrlsSameHost(actorJSON.id, actorUrl) !== true) {
2019-03-19 14:13:53 +01:00
logger.warn('Actor url %s has not the same host than its AP id %s', actorUrl, actorJSON.id)
return { result: undefined, statusCode: requestResult.response.statusCode }
2018-11-14 15:01:28 +01:00
}
2017-12-14 17:38:41 +01:00
const followersCount = await fetchActorTotalItems(actorJSON.followers)
const followingCount = await fetchActorTotalItems(actorJSON.following)
const actor = new ActorModel({
type: actorJSON.type,
2017-12-19 10:34:56 +01:00
preferredUsername: actorJSON.preferredUsername,
url: actorJSON.id,
2017-12-14 17:38:41 +01:00
publicKey: actorJSON.publicKey.publicKeyPem,
privateKey: null,
followersCount: followersCount,
followingCount: followingCount,
inboxUrl: actorJSON.inbox,
outboxUrl: actorJSON.outbox,
followersUrl: actorJSON.followers,
followingUrl: actorJSON.following,
sharedInboxUrl: actorJSON.endpoints && actorJSON.endpoints.sharedInbox
? actorJSON.endpoints.sharedInbox
2019-10-23 13:15:18 +02:00
: null
2017-12-14 17:38:41 +01:00
})
2019-08-09 11:32:40 +02:00
const avatarInfo = await getAvatarInfoIfExists(actorJSON)
2017-12-29 19:10:13 +01:00
2017-12-19 10:34:56 +01:00
const name = actorJSON.name || actorJSON.preferredUsername
2017-12-14 17:38:41 +01:00
return {
2018-08-24 11:04:02 +02:00
statusCode: requestResult.response.statusCode,
result: {
actor,
name,
2019-08-09 11:32:40 +02:00
avatar: avatarInfo,
2018-08-24 11:04:02 +02:00
summary: actorJSON.summary,
support: actorJSON.support,
2019-02-26 10:55:40 +01:00
playlists: actorJSON.playlists,
2018-08-24 11:04:02 +02:00
attributedTo: actorJSON.attributedTo
}
2017-12-14 17:38:41 +01:00
}
}
2019-08-15 11:53:26 +02:00
async function saveAccount (actor: MActorId, result: FetchRemoteActorResult, t: Transaction) {
const [ accountCreated ] = await AccountModel.findOrCreate({
defaults: {
name: result.name,
description: result.summary,
actorId: actor.id
},
where: {
actorId: actor.id
},
transaction: t
2017-12-14 17:38:41 +01:00
})
2019-08-15 11:53:26 +02:00
return accountCreated as MAccount
2017-12-14 17:38:41 +01:00
}
2019-08-15 11:53:26 +02:00
async function saveVideoChannel (actor: MActorId, result: FetchRemoteActorResult, ownerActor: MActorAccountId, t: Transaction) {
const [ videoChannelCreated ] = await VideoChannelModel.findOrCreate({
defaults: {
name: result.name,
description: result.summary,
support: result.support,
actorId: actor.id,
accountId: ownerActor.Account.id
},
where: {
actorId: actor.id
},
transaction: t
2017-12-14 17:38:41 +01:00
})
2019-08-15 11:53:26 +02:00
return videoChannelCreated as MChannel
2017-12-14 17:38:41 +01:00
}